forked from fa/breadcrumb-the-shire
fs
5f156661fd
Update security guard references from 9 to 10 (GR-SEC-010 was missing), code reviewer guards from 13 to 17 (new GR-CORE-LAYERS, GR-CORE-MODULE, GR-CORE-META, GR-UI-TAXONOMY), and total guard count from 22 to 27. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
46 lines
1.7 KiB
Markdown
46 lines
1.7 KiB
Markdown
# .agents/
|
|
|
|
Centralized home for the 7-role agent workflow system.
|
|
|
|
## Structure
|
|
|
|
```
|
|
workflow.md ← Roles, state machine, handover rules (start here)
|
|
contracts/ ← JSON schemas for role outputs (7 roles)
|
|
templates/ ← Starter JSON payloads per role (7 templates)
|
|
prompts/ ← Role-specific prompt baselines (7 prompts)
|
|
checks/ ← Guard catalog (27 guards), quality gates (9), checklists
|
|
← Enforcement policy + guard enforcement map
|
|
skills/ ← Reusable skill packages (guardrails, planner, grid, PHP CI)
|
|
runs/ ← Runtime artifacts per workflow run (gitignored)
|
|
```
|
|
|
|
## Roles
|
|
|
|
| # | Role | Artifact | Guards |
|
|
|---|---|---|---|
|
|
| 1 | Analyst | `analysis.json` | — |
|
|
| 2 | Planner | `plan.json` | selects guards |
|
|
| 3 | Executor | `execution-report.json` | provides evidence |
|
|
| 4 | Code Reviewer | `review-code.json` | 17 guards (GR-CORE/TEST/UI) |
|
|
| 5 | Security Reviewer | `review-security.json` | 10 guards (GR-SEC) |
|
|
| 6 | Acceptance Tester | `review-acceptance.json` | SC-* criteria |
|
|
| 7 | Finalizer | `finalize.json` | all reviews + CI |
|
|
|
|
## Quick Links
|
|
|
|
| What | Where |
|
|
|---|---|
|
|
| Workflow & roles | `workflow.md` |
|
|
| Guard catalog (27 guards) | `checks/guard-catalog.json` |
|
|
| Quality gates (9 gates) | `checks/quality-gates.json` |
|
|
| Enforcement policy | `checks/enforcement-policy.json` |
|
|
| Guard enforcement map | `checks/guard-enforcement-map.json` |
|
|
| Code review checklist | `checks/guard-checklist.md` |
|
|
| Acceptance checklist | `checks/acceptance-checklist.md` |
|
|
| Module manifest schema | `contracts/module-manifest.schema.json` |
|
|
|
|
## Project Context
|
|
|
|
See `CLAUDE.md` (repo root) for tech stack, architecture rules, and conventions.
|