| Feature | Progress | Status |
|---|---|---|
| Survey Dashboard |
|
Complete |
| Auth Integration |
|
In Progress |
| CI/CD Pipeline |
|
In Progress |
| Monitoring |
|
Queued |
Centralized specifications — version-controlled as a Git submodule alongside the codebase. Single source of truth for all product requirements.
| ID | Specification | Version | Tasks | Status | Last Updated |
|---|---|---|---|---|---|
| SPEC-001 | Survey Ingestion Pipeline | v1.2 | 4 / 4 | Complete | Mar 6 |
| SPEC-002 | Ghost Auth Reconciliation | v0.3 | 3 / 5 | In Progress | Mar 8 |
| SPEC-003 | VPC & Networking Layout | v1.0 | 2 / 2 | Complete | Mar 4 |
| SPEC-004 | CI/CD Pipeline Design | v0.2 | 1 / 3 | In Review | Mar 9 |
| SPEC-005 | Monitoring & Alerting | v0.1 | 0 / 2 | Draft | Mar 7 |
| SPEC-006 | Backup & Disaster Recovery | v0.1 | 0 / 2 | Draft | Mar 5 |
Tasks tied directly to specifications — status, assignment, and progress tracked against the spec they implement.
| Task | Spec | Assignee | Branch | Status |
|---|---|---|---|---|
| Configure Formbricks webhook sync | SPEC-001 | Agent | feat/formbricks-sync |
Done |
| Claude classification pipeline | SPEC-001 | Max | feat/classification |
Done |
| Evaluate Ghost JWT bridge | SPEC-002 | Max | feat/ghost-auth |
In Progress |
| Role mapping: Ghost → dashboard RBAC | SPEC-002 | Agent | feat/ghost-auth |
Blocked |
| Write Terraform for ALB + Route 53 | SPEC-003 | Agent | infra/networking |
Done |
| GitHub Actions: backend build + deploy | SPEC-004 | Max | feat/ci-backend |
In Progress |
| GitHub Actions: frontend build + deploy | SPEC-004 | Agent | — | Queued |
| CloudWatch dashboard + alarms | SPEC-005 | — | — | Queued |
Top-level feature definitions linked to their implementation tasks — a clear view from product vision to code.
Auto-generated documentation maintained as specifications evolve — design overviews, object models, and data flow diagrams.
| Document | Type | Source Spec | Generated |
|---|---|---|---|
| Survey Pipeline — Design Overview | Overview | SPEC-001 | Mar 6 |
| Survey Pipeline — Object Model | Object Model | SPEC-001 | Mar 6 |
| Ghost Bridge — Object Model | Object Model | SPEC-002 | Mar 7 |
| Auth System — Data Flow | Data Flow | SPEC-002 | Mar 8 |
| VPC Layout — Design Overview | Overview | SPEC-003 | Mar 4 |
| CI/CD — Data Flow | Data Flow | SPEC-004 | Mar 9 |
Specialized agents coordinated across engineering best practices — each responsible for a domain of quality.
Test Agent
ActiveGenerates and runs test suites against specs. Validates implementation matches requirements.
Design Review Agent
ActiveReviews code changes against spec requirements and architectural patterns. Flags drift.
Security Agent
ActiveAudits code for vulnerabilities, reviews IAM policies, validates secrets management.
Documentation Agent
IdleGenerates design overviews, object models, and data flow diagrams from spec changes.
Spec Agent
IdleMonitors spec consistency, detects conflicts between specifications, suggests updates.
Deploy Agent
IdleManages branch promotions, runs pre-deploy checks, coordinates staging → production flow.
Integration pipelines connecting external triggers to engineering workflows.
Slack message triggers Claude plan → feature branch creation.
User request flows through Claude planning → implementation → Slack notification on completion.
| Trigger | Pipeline | Result | Duration | Time |
|---|---|---|---|---|
| Slack: "Add export to PDF for council reports" | Design → Engineering | Planning | — | 1h ago |
Push to feat/ghost-auth |
Quality Gates | Passed | 48s | 3h ago |
Merge to dev |
Deploy → Staging | Deployed | 2m 14s | 3h ago |
Structured branch flow: Current → Dev → Future — with clear promotion paths and audit trails.
| Branch | Environment | Spec | Owner | Detail |
|---|---|---|---|---|
| main | Production | — | — | v1.2.0 · deployed Mar 4 |
| dev | Staging | — | — | +8 commits ahead · 2 PRs pending |
| feat/ghost-auth | Feature | SPEC-002 | Max + Agent | Ghost JWT bridge evaluation |
| feat/ci-backend | Feature | SPEC-004 | Max | GitHub Actions backend pipeline |
| future/monitoring | Future | SPEC-005 + SPEC-006 | — | Not started |
| Branch | Promoted To | By | Gates | Date |
|---|---|---|---|---|
feat/formbricks-sync |
dev → main | Max | All passed | Mar 4 |
feat/classification |
dev → main | Max | All passed | Mar 4 |
infra/networking |
dev → main | Agent | All passed | Mar 3 |
Git hooks enforcing engineering standards before code merges — automated checks that run whether the code was written by a human or an agent.
feat/ghost-auth (latest push)| Gate | Hook | Blocking | Applies To |
|---|---|---|---|
| Tests Pass | pre-merge |
Required | All branches |
| Spec Compliance | pre-merge |
Required | Feature branches |
| Security Audit | pre-merge |
Required | All branches |
| Design Review | pre-merge |
Advisory | Feature branches |
| Documentation | post-commit |
Advisory | All branches |
| Type Coverage | pre-merge |
Required | Frontend only |
SSM-based parameter and secrets management — keeping credentials out of code and version control.
| Parameter | Service | Type | Value | Last Rotated | Access |
|---|---|---|---|---|---|
/informup/prod/db/password |
PostgreSQL | SecureString | •••••••• | Mar 7 | Backend |
/informup/prod/db/host |
PostgreSQL | String | •••••••• | Mar 4 | Backend |
/informup/prod/anthropic/api_key |
Anthropic API | SecureString | •••••••• | Mar 1 | Backend |
/informup/prod/formbricks/api_key |
Formbricks | SecureString | •••••••• | Feb 28 | Backend |
/informup/prod/formbricks/webhook_secret |
Formbricks | SecureString | •••••••• | Feb 28 | Backend |
/informup/prod/ghost/admin_key |
Ghost CMS | SecureString | •••••••• | Mar 7 | Backend |
/informup/prod/ghost/jwt_secret |
Ghost CMS | SecureString | •••••••• | Mar 7 | Auth |
/informup/prod/slack/webhook_url |
Slack | SecureString | •••••••• | Mar 1 | Pipelines |
/informup/prod/github/deploy_key |
GitHub | SecureString | •••••••• | Mar 4 | CI/CD |
Permanent record of all engineering activity — who did what, when, on which spec or branch. Designed for funder and stakeholder transparency.
| Timestamp | Actor | Action | Target | Detail |
|---|---|---|---|---|
| Mar 9, 10:42 | Agent Design Review | Flagged issues | SPEC-004 | 2 design concerns on CI/CD pipeline spec |
| Mar 9, 10:38 | Agent Test | Tests passed | feat/survey-sync | 12/12 unit + integration tests |
| Mar 9, 10:32 | Human Max | Pushed commit | feat/ghost-auth | Ghost JWT evaluation — initial bridge attempt |
| Mar 9, 10:30 | System Gate | Gate failed | feat/ghost-auth | Type coverage: 2 errors in auth/ghost-bridge.ts |
| Mar 9, 10:18 | Agent Security | Audit passed | feat/ghost-auth | No vulnerabilities, secrets properly managed via SSM |
| Mar 9, 09:45 | System Pipeline | Pipeline triggered | Design → Engineering | Slack: Chris requested "Add export to PDF for council reports" |
| Mar 9, 09:30 | System Deploy | Staging deployed | dev | Build succeeded, deployed to staging environment |
| Mar 9, 09:28 | Human Max | Merged branch | feat/dashboard-auth → dev | All quality gates passed |
| Mar 8, 17:12 | Human Max | Updated spec | SPEC-002 | v0.2 → v0.3: Added fallback auth path |
| Mar 8, 16:50 | Agent Documentation | Generated doc | SPEC-002 | Auth System — Data Flow diagram regenerated |
| Mar 7, 14:30 | Human Max | Rotated secret | /informup/prod/ghost/* | Ghost admin key + JWT secret rotated |
| Mar 4, 11:00 | System Deploy | Production deployed | main | v1.2.0 — survey pipeline + networking |