9c1aaaa61f
Installs a 3-layer Cursor-aligned agent pipeline so future agent
sessions can orient quickly and stay inside guard rails:
L1 — context for any agent reading the repo:
- AGENTS.md (top-level orientation, conventions, no-go zones)
- .cursor/rules/ (no-go-zones, api-routes, prisma, prisma-schema-map)
- .cursor/skills/ (add-api-route, add-prisma-model)
- docs/SCHEMA_MAP.md generated from prisma/schema.prisma
- scripts/generate-schema-map.ts (regenerate the map; wired up as
`npm run schema:map`)
L2 — subagent roles for the 9-stage idea-to-feature pipeline:
- .cursor/agents/role-*.md (conductor, architect, ia-architect,
design-system-auditor, implementer, reviewer, ux-reviewer,
a11y-auditor, doc-writer) with explicit multitask annotations.
L3 — pipeline scaffolding:
- .github/CODEOWNERS, PR template, and CI workflows (ci.yml,
preview-smoke.yml, visual-diff.yml, pr-health-rollup.yml).
Test job is intentionally disabled until Playwright is wired up.
- .convoys/ folder for per-feature run notes + scripts/log-convoy-event.sh.
- scripts/wt.sh worktree helper.
- src/lib/flags/index.ts simple env-driven feature flag wrapper.
- tests/smoke/app.smoke.spec.ts (Playwright smoke; excluded from
tsc until @playwright/test is installed — see tsconfig change).
Also writes .agent-context-manifest.yml so the sync-agent-context
skill can detect drift and offer selective updates from upstream.
Follow-ups (not in this commit):
- Install @playwright/test and re-enable the test job in ci.yml.
- Review .cursor/agents/role-*.md and trim any roles that don't
apply to this codebase.
Co-authored-by: Cursor <cursoragent@cursor.com>
44 lines
1.1 KiB
Markdown
44 lines
1.1 KiB
Markdown
<!--
|
|
pipeline: convoy=<slug>, brief=<N>
|
|
skip: <comma-separated flags or empty>
|
|
|
|
Skip flags (Conductor sets these — do not edit by hand):
|
|
ia, ux, arch, test, review, visual, a11y, design, smoke, qa, docs, flag
|
|
Never skip: plan-approval, pr-merge, prod-promote
|
|
-->
|
|
|
|
## Summary
|
|
|
|
<!-- 2-3 bullets: what changed and why. User-facing language preferred. -->
|
|
|
|
## Convoy + Brief
|
|
|
|
- Convoy: `.convoys/<slug>.md`
|
|
- Brief: `.convoys/<slug>/brief-<N>-...md`
|
|
|
|
## Acceptance criteria
|
|
|
|
<!-- Copy from the brief; check off as you complete. -->
|
|
|
|
- [ ]
|
|
- [ ]
|
|
- [ ] No scope expansion (only files listed in the brief's `files:` were edited)
|
|
|
|
## Test plan
|
|
|
|
<!-- What was tested, how, and what wasn't tested with rationale. -->
|
|
|
|
## Pipeline gates
|
|
|
|
<!-- Filled in by CI / role-reviewer. Don't edit. -->
|
|
|
|
- [ ] CI: lint, types, build, unit tests
|
|
- [ ] Visual diff (if UI change)
|
|
- [ ] A11y audit (if UI change)
|
|
- [ ] Design-system audit (if UI change)
|
|
- [ ] Reviewer report
|
|
- [ ] Smoke on staging (after merge to develop)
|
|
|
|
## Notes for reviewer
|
|
|
|
<!-- Anything unusual, intentional trade-offs, or follow-ups. -->
|