From 223c94f52ebaa878f6951ebf7d08754e413bdca7 Mon Sep 17 00:00:00 2001 From: Peter Stone Date: Thu, 5 Feb 2026 10:37:09 -1000 Subject: Document multi-agent workflow, ADRs, and Agent API - Add Development Workflow section to DESIGN.md documenting three-role system (Architect, Implementor, Reviewer) with handoff documents - Update CLAUDE.md with Key Documents section pointing to DESIGN.md, role definitions, and ADRs - Add ADR-first documentation policy across all role definitions - Update REVIEWER_ROLE.md with comprehensive test quality checklist - Document Agent API and completed tasks log in DESIGN.md - Update database schema table with 5 missing tables - Update endpoint reference with 10 missing routes - Create ADRs 002-005 capturing key architectural decisions: - 002: Timeline aggregation architecture - 003: HTMX write operations pattern - 004: Concurrent data fetching with graceful degradation - 005: Agent API notification-based authentication - Add migrations/README.md documenting schema history and 007 gap Co-Authored-By: Claude Opus 4.5 --- IMPLEMENTOR_ROLE.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'IMPLEMENTOR_ROLE.md') diff --git a/IMPLEMENTOR_ROLE.md b/IMPLEMENTOR_ROLE.md index 62bfd7e..31c3f53 100644 --- a/IMPLEMENTOR_ROLE.md +++ b/IMPLEMENTOR_ROLE.md @@ -23,7 +23,8 @@ 2. **Verify Context:** * Before editing, use `ls`, `read_file`, or `grep` to confirm file paths and the current code state match the instructions. - * If the instructions seem outdated or conflict with the current codebase, stop and ask for clarification. + * **Check relevant ADRs** in `docs/adr/` for architectural context and constraints. + * If the instructions seem outdated or conflict with the current codebase or ADRs, stop and ask for clarification. 3. **Test-Driven Execution (TDD):** * **Pre-Check:** Run existing tests (`go test ./...`) or the specific reproduction test case provided to confirm the baseline (fail state for bugs, pass state for refactors). -- cgit v1.2.3