fa/breadcrumb-the-shire
1
0
Fork 1
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
Files
dba589b4957bef91a9a5bbd41642a1baea540280
breadcrumb-the-shire/.agents/README.md

46 lines
1.7 KiB
Markdown
Raw Normal View History

feat: module architecture improvements — session keys, dependency graph, event dispatcher, deactivation hooks Six targeted improvements to the modular monolith platform: 1. Fix AddressBook session key prefix to follow module.<id>.* convention 2. Move ADDRESS_BOOK_VIEW permission constant from core PermissionService into module 3. Add declarative JSON schema for module manifests (.agents/contracts/) 4. Add `requires` field with missing-dependency and circular-dependency detection 5. Add lightweight fire-and-forget event dispatcher (user.created/deleted/login/logout) 6. Add module deactivation hook interface and CLI script (bin/module-deactivate.php) Includes 15 new architecture/unit tests covering all new functionality. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 18:20:13 +01:00
# .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 (22 guards), quality gates (9), checklists
chore(agents): implement v2 hardening and enforcement-ready QA
2026-04-01 19:41:56 +02:00
← Enforcement policy + guard enforcement map
feat: module architecture improvements — session keys, dependency graph, event dispatcher, deactivation hooks Six targeted improvements to the modular monolith platform: 1. Fix AddressBook session key prefix to follow module.<id>.* convention 2. Move ADDRESS_BOOK_VIEW permission constant from core PermissionService into module 3. Add declarative JSON schema for module manifests (.agents/contracts/) 4. Add `requires` field with missing-dependency and circular-dependency detection 5. Add lightweight fire-and-forget event dispatcher (user.created/deleted/login/logout) 6. Add module deactivation hook interface and CLI script (bin/module-deactivate.php) Includes 15 new architecture/unit tests covering all new functionality. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 18:20:13 +01:00
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` | 13 guards (GR-CORE/TEST/UI) |
| 5 | Security Reviewer | `review-security.json` | 9 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 (22 guards) | `checks/guard-catalog.json` |
| Quality gates (9 gates) | `checks/quality-gates.json` |
chore(agents): implement v2 hardening and enforcement-ready QA
2026-04-01 19:41:56 +02:00
| Enforcement policy | `checks/enforcement-policy.json` |
| Guard enforcement map | `checks/guard-enforcement-map.json` |
feat: module architecture improvements — session keys, dependency graph, event dispatcher, deactivation hooks Six targeted improvements to the modular monolith platform: 1. Fix AddressBook session key prefix to follow module.<id>.* convention 2. Move ADDRESS_BOOK_VIEW permission constant from core PermissionService into module 3. Add declarative JSON schema for module manifests (.agents/contracts/) 4. Add `requires` field with missing-dependency and circular-dependency detection 5. Add lightweight fire-and-forget event dispatcher (user.created/deleted/login/logout) 6. Add module deactivation hook interface and CLI script (bin/module-deactivate.php) Includes 15 new architecture/unit tests covering all new functionality. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 18:20:13 +01:00
| 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.
Reference in New Issue Copy Permalink