Files
git.stella-ops.org/docs/features/checked/docs/implementor-guidelines-document.md
2026-02-12 10:27:23 +02:00

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.md files -- per-module implementation guidelines that add module-specific rules without relaxing repo-wide standards.
  • Sprint Template: Defined in CLAUDE.md section 6 -- mandatory sprint file structure (Topic & Scope, Dependencies, Delivery Tracker, Execution Log, Decisions & Risks).

E2E Test Plan

  • Verify the CODE_OF_CONDUCT.md file exists and covers all sections referenced by the repo-wide agent contract (naming, error handling, commit discipline)
  • Verify the TESTING_PRACTICES.md file exists and defines all required test layers (unit, integration, E2E, performance, security)
  • Verify that at least 5 module directories under src/ contain a module-local AGENTS.md file
  • Verify the sprint template in CLAUDE.md section 6 is complete and includes all required sections
  • Verify a new contributor can locate the implementor guidelines from the docs/README.md entry 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