llms.txt

# DSO Plugin — Agent Sitemap
# Format: path | tier | description

## Tier 1: Navigation
CLAUDE.md | nav | Agent rules, commands, architectural invariants, critical rules
README.md | nav | Project orientation (stub — see CLAUDE.md)

## Tier 3: Living Reference
docs/reference/system-landscape.md | reference | Plugin root resolution order, command wrappers, portability lint, agent fallback, test quality overlay, pre-commit test quality gate, stack-aware config pre-fill (prefill-config.sh), CI skeleton templates (hashFiles)
docs/reference/domain-logic.md | reference | Fix-bug gate pipeline, gate signal contract, escalation router; brainstorm planning pipeline (follow-on scrutiny, feasibility-resolution gate, prompt-alignment step)

## Project-Local Artifact Directories
docs/designs/ | artifacts | Design and UI artifacts (wireframes, spatial layouts, design manifests) — project-local, not distributed with plugin
docs/findings/ | artifacts | Investigation results and research findings — project-local, not distributed with plugin
docs/archive/ | artifacts | Superseded documents and archived artifacts — project-local, not distributed with plugin

## Tier 4: ADRs
docs/adr/0001-shim-sentinel-self-detection.md | adr | Why shim step 3 (sentinel self-detection) was added
docs/adr/0002-sprint-gap-detection-and-routing.md | adr | Why sprint self-healing checkpoints and confidence signal routing were added
docs/adr/0003-brainstorm-planning-pipeline-hardening.md | adr | Why follow-on epic scrutiny, feasibility-resolution gate, and prompt-alignment step were added to brainstorm
docs/adr/0007-stack-aware-architect-foundation.md | adr | Why prefill-config.sh and hashFiles() CI skeletons were added to architect-foundation

## Plugin Source
plugins/dso/scripts/check-portability.sh | source | Pre-commit portability lint (flags /Users/ and /home/ hardcoded paths)
plugins/dso/scripts/check-contract-schemas.sh | source | Pre-commit contract schema validation (enforces # Contract: heading, Purpose section, canonical parsing prefix for signal contracts)
plugins/dso/scripts/check-referential-integrity.sh | source | Pre-commit referential integrity check (verifies path references in skill/agent/workflow docs point to real files)
plugins/dso/hooks/pre-commit-test-quality-gate.sh | source | Pre-commit test quality gate (blocks anti-pattern tests; configurable via test_quality.* in dso-config.conf)
.claude/hooks/pre-commit/check-plugin-self-ref.sh | source | Pre-commit hook that detects plugin self-references (absolute zero policy — no annotation bypass)
plugins/dso/hooks/semgrep-rules/test-anti-patterns.yaml | source | Semgrep custom rules for test anti-pattern detection
plugins/dso/agents/code-reviewer-test-quality.md | source | Test quality overlay agent (opus); evaluates test bloat patterns in review diffs
plugins/dso/scripts/prefill-config.sh | source | Stack-aware config pre-fill for dso-config.conf (invoked by architect-foundation Step 0.75)
plugins/dso/scripts/validate.sh | source | Full validation suite
plugins/dso/scripts/merge-to-main.sh | source | Worktree-to-main merge orchestration
plugins/dso/docs/WORKTREE-GUIDE.md | guide | Worktree lifecycle, session setup, concurrent sessions
plugins/dso/docs/ticket-cli-reference.md | guide | Ticket CLI full reference