2.6 KiB
2.6 KiB
Implementor Guidelines Document
Module
docs
Status
VERIFIED
Description
The implementor guidelines document exists at the declared path covering operational checklists for code and doc changes.
Implementation Details
- Code of Conduct:
docs/code-of-conduct/CODE_OF_CONDUCT.md-- binding coding standards for all implementers covering naming conventions, error handling patterns, commit discipline, and code review expectations. - Testing Practices:
docs/code-of-conduct/TESTING_PRACTICES.md-- testing standards defining required test layers (unit, integration, E2E, performance, security), determinism requirements, and flakiness policies. - Repo-Wide Agent Contract:
CLAUDE.md-- defines sprint file discipline, directory ownership, git safety rules, documentation sync requirements, dependency license gates, and role-based behavior contracts. - Module-Local AGENTS.md: Various
src/<module>/AGENTS.mdfiles -- per-module implementation guidelines that add module-specific rules without relaxing repo-wide standards. - Sprint Template: Defined in
CLAUDE.mdsection 6 -- mandatory sprint file structure (Topic & Scope, Dependencies, Delivery Tracker, Execution Log, Decisions & Risks).
E2E Test Plan
- Verify the
CODE_OF_CONDUCT.mdfile exists and covers all sections referenced by the repo-wide agent contract (naming, error handling, commit discipline) - Verify the
TESTING_PRACTICES.mdfile exists and defines all required test layers (unit, integration, E2E, performance, security) - Verify that at least 5 module directories under
src/contain a module-localAGENTS.mdfile - Verify the sprint template in
CLAUDE.mdsection 6 is complete and includes all required sections - Verify a new contributor can locate the implementor guidelines from the
docs/README.mdentry point within 2 navigation steps
Verification
- Verified on 2026-02-11 via FLOW Tier 0/1/2 replay in
run-002. - Tier 0:
docs/qa/feature-checks/runs/docs/implementor-guidelines-document/run-002/tier0-source-check.json - Tier 1:
docs/qa/feature-checks/runs/docs/implementor-guidelines-document/run-002/tier1-build-check.json - Tier 2:
docs/qa/feature-checks/runs/docs/implementor-guidelines-document/run-002/tier2-integration-check.json - Failure loop artifacts:
docs/qa/feature-checks/runs/docs/implementor-guidelines-document/run-001/triage.json,docs/qa/feature-checks/runs/docs/implementor-guidelines-document/run-001/confirmation.json,docs/qa/feature-checks/runs/docs/implementor-guidelines-document/run-001/fix-summary.json,docs/qa/feature-checks/runs/docs/implementor-guidelines-document/run-001/retest-result.json