Imported from 95gabor/agentic-workflow (
.agents/AGENTS.md). Install upstream withnpx skills add 95gabor/agentic-workflow --skill .agents. Copyright stays with the author.
Agent Routing
Instructions for Cursor agents working in this repository.
Skill load order
- Always read first:
.agents/skills/project-context/SKILL.md— product, stack, docs index, UI language, layout. - Domain tasks: any project domain skill under
.agents/skills/<domain>/(when present and relevant). - Stack and practice skills:
.agents/skills/— pick by task:architecture/SKILL.md— system design, cross-cutting changesclean-code/SKILL.md— refactors and reviewstypescript/SKILL.md— strict TS, ESLint, types (all TypeScript code)developer-quality/SKILL.md— lint, format, tests (implementation roles)security-review/SKILL.md— security-reviewer checklistsux-ui-review/SKILL.md— ux-reviewer heuristicsseo/SKILL.md— landing SEO, metadata, sitemap, analyticsvisual-design/SKILL.md— design system, SVG illustrationsbmad/SKILL.md— planning and phased delivery
- Optional stack pack (NestJS / Next.js / Playwright) — only if present under
.agents/skills/optional/:optional/nestjs-backend/SKILL.md— NestJS APIoptional/nextjs-frontend/SKILL.md— Next.js App Routeroptional/playwright-e2e/SKILL.md— Playwright E2E
Skill locations
| Skill | Path |
|---|---|
| Project context | .agents/skills/project-context/SKILL.md |
| Architecture | .agents/skills/architecture/SKILL.md |
| Clean code | .agents/skills/clean-code/SKILL.md |
| TypeScript | .agents/skills/typescript/SKILL.md |
| Developer quality | .agents/skills/developer-quality/SKILL.md |
| Security review | .agents/skills/security-review/SKILL.md |
| UX / UI review | .agents/skills/ux-ui-review/SKILL.md |
| SEO & analytics | .agents/skills/seo/SKILL.md |
| Visual design | .agents/skills/visual-design/SKILL.md |
| BMAD planning | .agents/skills/bmad/SKILL.md |
| NestJS backend (optional) | .agents/skills/optional/nestjs-backend/SKILL.md |
| Next.js frontend (optional) | .agents/skills/optional/nextjs-frontend/SKILL.md |
| Playwright E2E (optional) | .agents/skills/optional/playwright-e2e/SKILL.md |
Routing entry point: .agents/AGENTS.md.
Subagent workflow
For multi-phase features, requirements, and decisions, the main Cursor agent acts as Project Manager (PM) and delegates to specialists under .cursor/agents/.
| Resource | Purpose |
|---|---|
| docs/AGENT_WORKFLOW.md | End-to-end workflow: Type A (decision), Type B (feature), Type C (bug/fix), phases, handoffs, anti-patterns |
| docs/handoffs/README.md | Structured handoff artifact chain — folder convention, file ownership, PM gates |
.cursor/agents/ |
Custom subagent definitions (invoke with /name, e.g. /product-owner, /architect) |
PM orchestrates — does not skip phases without justification, synthesizes subagent outputs, records decisions in docs/DECISIONS.md.
| Subagent | Role | Model | Readonly | Handoff output |
|---|---|---|---|---|
| PM (main agent) | Orchestration, intake | — | — | 00-intake.md |
business-analyst |
Requirements, user stories | claude-sonnet-5-thinking-high |
no (docs only) | 01-requirements-brief.md |
marketing-specialist |
User-facing copy, landing messaging | gpt-5.6-terra-medium |
no (docs only) | 02-copy-brief.md |
visual-designer |
Design system, SVG illustrations, OG assets | gpt-5.6-terra-medium |
no (assets only) | 02c-visual-design.md, docs/design/DESIGN_SYSTEM.md |
product-owner |
Scope, acceptance criteria, prioritization | claude-sonnet-5-thinking-high |
no (docs only) | 03-acceptance-criteria.md |
architect |
System design, ADR drafts, API/data model | claude-opus-4-8-thinking-high |
no (docs only) | 04-architecture-design.md, docs/adrs/ |
security-reviewer |
Design + implementation security review | claude-sonnet-5-thinking-high |
no (docs only) | 04b-security-design-review.md, 08-security-implementation-review.md |
ux-reviewer |
Usability, wireframe validation (post-QA) | gpt-5.6-terra-medium |
no (docs only) | 09-ux-review.md |
frontend-developer |
Frontend app | composer-2.5-fast |
no | 05-implementation-frontend.md — lint, tests, coverage required |
backend-developer |
Backend app | composer-2.5-fast |
no | 05-implementation-backend.md — lint, tests, coverage required |
qa-tester |
Test plans, run tests, verification | claude-sonnet-5-thinking-high |
no | 06-qa-report.md — includes return target on fail |
devops-engineer |
Docker, compose, CI, env | gpt-5.6-sol-medium |
no | 07-devops-notes.md |
Model slugs and rationale: Subagent model configuration.
Doc-only roles (business-analyst, marketing-specialist, product-owner, architect, security-reviewer, ux-reviewer) must not modify application source — they write to docs/handoffs/ and (architect) docs/adrs/ + docs/DECISIONS.md. visual-designer may write SVG/PNG under the public assets path defined in project-context only.
Subagents read .agents/skills/project-context/SKILL.md (and stack/domain skills) when the PM includes them in the handoff. Skills live in .agents/skills/; subagents live in .cursor/agents/.
Project documentation (docs/)
| Document | Purpose |
|---|---|
| docs/PRODUCT_VISION.md | Vision, audience, non-goals |
| docs/REQUIREMENTS.md | Functional and non-functional requirements |
| docs/ARCHITECTURE.md | System design, modules, API flows |
| docs/DATA_MODEL.md | Entities, relationships |
| docs/AGENT_WORKFLOW.md | PM-orchestrated subagent workflow |
| docs/handoffs/README.md | Structured handoff artifacts per feature |
| docs/adrs/README.md | Significant architecture decision records |
| docs/DECISIONS.md | Architecture and product decision log |
| docs/design/DESIGN_SYSTEM.md | Brand tokens and illustration style |
Defaults
- End-user UI language: as defined in
project-context(template default: English). - Code, commits, and
docs/: English. - Prefer Multitask Mode for Type B workflows so specialist subagents can run properly.