# Subsystem: claude_md_orchestrator

## skills/claude_md_orchestrator/__init__.py
- Doc: Public API for the claude_md_orchestrator skill.
- Layer: utility
- Language: py
- Depends on: `skills/claude_md_orchestrator/config.py`, `skills/claude_md_orchestrator/models.py`, `skills/claude_md_orchestrator/orchestrator.py`
- Imported by: `tests/test_security_codeql_batch.py`

## skills/claude_md_orchestrator/bdd_agent.py
- Doc: Behavior-Driven Development agent.
- Layer: utility
- Language: py
- Symbols:
  - `_module_name` (function, line 80) `def _module_name(contract)`
  - `_module_path` (function, line 85) `def _module_path(contract, config)`
  - `_package_init` (function, line 90) `def _package_init(config)`
  - `_compose_implementation` (function, line 95) `def _compose_implementation(spec, contract)`
  - `BddResult` (class, line 113) `class BddResult`
  - `_ensure_init` (function, line 130) `def _ensure_init(config)`
  - `_run_pytest` (function, line 138) `def _run_pytest(test_path, cwd)`
  - `run` (function, line 151) `def run(contract, spec, suite, config)`
- Depends on: `skills/claude_md_orchestrator/config.py`, `skills/claude_md_orchestrator/models.py`, `skills/claude_md_orchestrator/tdd_agent.py`, `skills/claude_md_orchestrator/validators.py`

## skills/claude_md_orchestrator/boy_scout.py
- Doc: Boy Scout refactor pass.
- Layer: utility
- Language: py
- Symbols:
  - `ScoutReport` (class, line 30) `class ScoutReport`
  - `_inspect` (function, line 45) `def _inspect(path)`
  - `_render_proposal` (function, line 73) `def _render_proposal(contract, findings)`
  - `run` (function, line 90) `def run(state, config)`
  - `write_report` (function, line 110) `def write_report(report, config)`
- Depends on: `skills/claude_md_orchestrator/config.py`, `skills/claude_md_orchestrator/models.py`, `skills/claude_md_orchestrator/validators.py`

## skills/claude_md_orchestrator/cicd_agent.py
- Doc: CI and CD agent.
- Layer: utility
- Language: py
- Symbols:
  - `CicdResult` (class, line 71) `class CicdResult`
  - `_slug` (function, line 91) `def _slug(contract)`
  - `_git` (function, line 97) `def _git()`
  - `_ensure_branch` (function, line 108) `def _ensure_branch(contract, config)`
  - `_render_pipeline` (function, line 134) `def _render_pipeline(contract, spec, config)`
  - `_render_pr_body` (function, line 144) `def _render_pr_body(contract, spec, report)`
  - `run` (function, line 177) `def run(contract, spec, report, config)`
- Depends on: `skills/claude_md_orchestrator/config.py`, `skills/claude_md_orchestrator/models.py`

## skills/claude_md_orchestrator/config.py
- Doc: Centralized configuration for the claude_md_orchestrator skill.
- Layer: infrastructure
- Language: py
- Symbols:
  - `_repo_root` (function, line 22) `def _repo_root()`
  - `_default_run_dir` (function, line 37) `def _default_run_dir()`
  - `_default_claude_md` (function, line 52) `def _default_claude_md()`
  - `Config` (class, line 67) `class Config`
  - `load_config` (function, line 155) `def load_config()`
  - `resolve_optional` (function, line 164) `def resolve_optional(config, key)`
  - `ensure` (method, line 112) `def ensure(self)`
  - `state_path` (method, line 122) `def state_path(self)`
  - `specs_dir` (method, line 126) `def specs_dir(self)`
  - `tests_dir` (method, line 130) `def tests_dir(self)`
  - `src_dir` (method, line 134) `def src_dir(self)`
  - `review_dir` (method, line 138) `def review_dir(self)`
  - `docs_dir` (method, line 142) `def docs_dir(self)`
  - `logs_dir` (method, line 146) `def logs_dir(self)`
  - `log_path` (method, line 150) `def log_path(self)`
- Imported by: `skills/claude_md_orchestrator/__init__.py`, `skills/claude_md_orchestrator/bdd_agent.py`, `skills/claude_md_orchestrator/boy_scout.py`, `skills/claude_md_orchestrator/cicd_agent.py`, `skills/claude_md_orchestrator/documentation_agent.py`, `skills/claude_md_orchestrator/orchestrator.py`, `skills/claude_md_orchestrator/parser.py`, `skills/claude_md_orchestrator/reviewer_agent.py`, `skills/claude_md_orchestrator/sdd_agent.py`, `skills/claude_md_orchestrator/tdd_agent.py`

## skills/claude_md_orchestrator/documentation_agent.py
- Doc: Documentation agent.
- Layer: utility
- Language: py
- Symbols:
  - `DocResult` (class, line 28) `class DocResult`
  - `_format_inputs` (function, line 40) `def _format_inputs(spec)`
  - `_format_sad_paths` (function, line 47) `def _format_sad_paths(spec)`
  - `_format_review` (function, line 54) `def _format_review(report)`
  - `_render` (function, line 68) `def _render(contract, spec, report)`
  - `_wrap` (function, line 118) `def _wrap(body)`
  - `run` (function, line 123) `def run(contract, spec, report, config)`
- Depends on: `skills/claude_md_orchestrator/config.py`, `skills/claude_md_orchestrator/models.py`

## skills/claude_md_orchestrator/models.py
- Doc: Data models for the claude_md_orchestrator skill.
- Layer: business_logic
- Language: py
- Symbols:
  - `_now_iso` (function, line 19) `def _now_iso()`
  - `Stage` (class, line 28) `class Stage(StrEnum)`
  - `Severity` (class, line 50) `class Severity(StrEnum)`
  - `Contract` (class, line 68) `class Contract`
  - `SadPath` (class, line 109) `class SadPath`
  - `Spec` (class, line 134) `class Spec`
  - `TestSuite` (class, line 217) `class TestSuite`
  - `Finding` (class, line 255) `class Finding`
  - `ReviewReport` (class, line 291) `class ReviewReport`
  - `CicleState` (class, line 348) `class CicleState`
  - `CicleStateFile` (class, line 424) `class CicleStateFile`
  - `write_jsonl` (function, line 480) `def write_jsonl(path, event)`
  - `to_dict` (method, line 91) `def to_dict(self)`
  - `from_dict` (method, line 96) `def from_dict(cls, data)`
  - `to_dict` (method, line 120) `def to_dict(self)`
  - `from_dict` (method, line 125) `def from_dict(cls, data)`
  - `to_dict` (method, line 166) `def to_dict(self)`
  - `from_dict` (method, line 173) `def from_dict(cls, data)`
  - `validate` (method, line 189) `def validate(self, min_sad_paths)`
  - `to_dict` (method, line 236) `def to_dict(self)`
  - `from_dict` (method, line 243) `def from_dict(cls, data)`
  - `to_dict` (method, line 270) `def to_dict(self)`
  - `from_dict` (method, line 280) `def from_dict(cls, data)`
  - `blockers` (method, line 315) `def blockers(self)`
  - `to_dict` (method, line 319) `def to_dict(self)`
  - `from_dict` (method, line 333) `def from_dict(cls, data)`
  - `to_dict` (method, line 383) `def to_dict(self)`
  - `from_dict` (method, line 402) `def from_dict(cls, data)`
  - `to_dict` (method, line 440) `def to_dict(self)`
  - `from_dict` (method, line 450) `def from_dict(cls, data)`
  - `save` (method, line 459) `def save(self, path)`
  - `load` (method, line 467) `def load(cls, path)`
- Depends on: `cli/commands/enum.py`
- Imported by: `skills/claude_md_orchestrator/__init__.py`, `skills/claude_md_orchestrator/bdd_agent.py`, `skills/claude_md_orchestrator/boy_scout.py`, `skills/claude_md_orchestrator/cicd_agent.py`, `skills/claude_md_orchestrator/documentation_agent.py`, `skills/claude_md_orchestrator/orchestrator.py`, `skills/claude_md_orchestrator/parser.py`, `skills/claude_md_orchestrator/reviewer_agent.py`, `skills/claude_md_orchestrator/sdd_agent.py`, `skills/claude_md_orchestrator/tdd_agent.py`, `skills/claude_md_orchestrator/validators.py`

## skills/claude_md_orchestrator/orchestrator.py
- Doc: Orchestrator that wires the agents into a deterministic pipeline.
- Layer: utility
- Language: py
- Symbols:
  - `CycleSummary` (class, line 34) `class CycleSummary`
  - `_banner` (function, line 52) `def _banner(message, config)`
  - `_halt` (function, line 59) `def _halt(summary, contract_id, reason)`
  - `_persist` (function, line 66) `def _persist(state, config)`
  - `_load_state` (function, line 84) `def _load_state(config)`
  - `_seed_state` (function, line 89) `def _seed_state(contracts, state)`
  - `_run_spec` (function, line 97) `def _run_spec(state, config)`
  - `_run_test` (function, line 110) `def _run_test(state, config)`
  - `_run_implementation` (function, line 125) `def _run_implementation(state, config)`
  - `_run_review` (function, line 146) `def _run_review(state, config)`
  - `_run_documentation` (function, line 158) `def _run_documentation(state, config)`
  - `_run_scout` (function, line 174) `def _run_scout(state, config)`
  - `_run_cicd` (function, line 182) `def _run_cicd(state, config)`
  - `_load_spec` (function, line 217) `def _load_spec(path)`
  - `_advance` (function, line 234) `def _advance(state, contract_id, config, options)`
  - `run` (function, line 275) `def run(config, options)`
  - `_print_summary` (function, line 301) `def _print_summary(summary)`
  - `summary_to_dict` (function, line 306) `def summary_to_dict(summary)`
  - `_build_parser` (function, line 324) `def _build_parser()`
  - `_load_seed_contracts` (function, line 365) `def _load_seed_contracts(args, options)`
  - `main` (function, line 393) `def main(argv)`
- Depends on: `skills/claude_md_orchestrator/config.py`, `skills/claude_md_orchestrator/models.py`, `skills/claude_md_orchestrator/parser.py`
- Imported by: `skills/claude_md_orchestrator/__init__.py`

## skills/claude_md_orchestrator/parser.py
- Doc: Parser that turns a CLAUDE.md into actionable contracts.
- Layer: utility
- Language: py
- Symbols:
  - `_Section` (class, line 34) `class _Section`
  - `_derive_contract_id` (function, line 56) `def _derive_contract_id(title, fallback_index)`
  - `_strip_contract_marker` (function, line 73) `def _strip_contract_marker(title)`
  - `_walk_sections` (function, line 85) `def _walk_sections(lines)`
  - `_collect_bullets` (function, line 123) `def _collect_bullets(text)`
  - `_collect_paragraphs` (function, line 141) `def _collect_paragraphs(text)`
  - `_is_actionable` (function, line 146) `def _is_actionable(heading)`
  - `_flatten_actionable` (function, line 159) `def _flatten_actionable(root)`
  - `parse_claude_md` (function, line 167) `def parse_claude_md(path)`
  - `_coerce_seed_contract` (function, line 205) `def _coerce_seed_contract(seed)`
  - `load_contracts` (function, line 225) `def load_contracts(config, seeds)`
  - `__post_init__` (method, line 51) `def __post_init__(self)`
  - `flush_body` (function, line 97) `def flush_body()`
- Depends on: `skills/claude_md_orchestrator/config.py`, `skills/claude_md_orchestrator/models.py`
- Imported by: `pwntomate.py`, `skills/claude_md_orchestrator/orchestrator.py`, `static/js/xterm.js`, `utils.py`

## skills/claude_md_orchestrator/reviewer_agent.py
- Doc: Code Reviewer and Quality Assurance agent.
- Layer: utility
- Language: py
- Symbols:
  - `AnalyzerResult` (class, line 30) `class AnalyzerResult`
  - `_run` (function, line 46) `def _run(cmd, cwd)`
  - `_resolve_targets` (function, line 72) `def _resolve_targets(state, config)`
  - `_parse_tool_findings` (function, line 88) `def _parse_tool_findings(result, path_prefix)`
  - `_run_ruff` (function, line 121) `def _run_ruff(targets, cwd)`
  - `_run_mypy` (function, line 134) `def _run_mypy(targets, cwd)`
  - `_run_bandit` (function, line 147) `def _run_bandit(targets, cwd)`
  - `_run_pytest` (function, line 160) `def _run_pytest(targets, cwd)`
  - `run` (function, line 171) `def run(state, config)`
  - `write_report` (function, line 225) `def write_report(report, config)`
- Depends on: `skills/claude_md_orchestrator/config.py`, `skills/claude_md_orchestrator/models.py`, `skills/claude_md_orchestrator/validators.py`

## skills/claude_md_orchestrator/sdd_agent.py
- Doc: Spec-Driven Development agent.
- Layer: utility
- Language: py
- Symbols:
  - `SddResult` (class, line 40) `class SddResult`
  - `_coerce_scope` (function, line 56) `def _coerce_scope(scope)`
  - `_compose_spec` (function, line 81) `def _compose_spec(contract, min_sad_paths)`
  - `_render_yaml` (function, line 130) `def _render_yaml(spec)`
  - `_ask_llm` (function, line 148) `def _ask_llm(contract, backend)`
  - `run` (function, line 204) `def run(contract, config)`
- Depends on: `modules/llm_factory.py`, `skills/claude_md_orchestrator/config.py`, `skills/claude_md_orchestrator/models.py`, `skills/claude_md_orchestrator/validators.py`

## skills/claude_md_orchestrator/tdd_agent.py
- Doc: Test-Driven Development agent.
- Layer: utility
- Language: py
- Symbols:
  - `_slug` (function, line 79) `def _slug(value)`
  - `TddResult` (class, line 90) `class TddResult`
  - `_module_name` (function, line 105) `def _module_name(contract)`
  - `_compose_tests` (function, line 110) `def _compose_tests(spec, contract)`
  - `_run_pytest` (function, line 154) `def _run_pytest(test_path, cwd)`
  - `run` (function, line 175) `def run(contract, spec, config)`
  - `read_test_source` (function, line 228) `def read_test_source(test_path)`
- Depends on: `skills/claude_md_orchestrator/config.py`, `skills/claude_md_orchestrator/models.py`, `skills/claude_md_orchestrator/validators.py`
- Imported by: `skills/claude_md_orchestrator/bdd_agent.py`

## skills/claude_md_orchestrator/validators.py
- Doc: DoD validators for every artifact the orchestrator produces.
- Layer: utility
- Language: py
- Symbols:
  - `_EmojiSpan` (class, line 57) `class _EmojiSpan`
  - `_EmojiPattern` (class, line 74) `class _EmojiPattern`
  - `CheckResult` (class, line 96) `class CheckResult`
  - `find_block_comments` (function, line 116) `def find_block_comments(source)`
  - `find_inline_comments` (function, line 138) `def find_inline_comments(source)`
  - `check_no_comments` (function, line 155) `def check_no_comments(source, path)`
  - `check_no_emoji` (function, line 186) `def check_no_emoji(content, path)`
  - `check_no_forbidden_markers` (function, line 208) `def check_no_forbidden_markers(content, path)`
  - `check_english_only` (function, line 225) `def check_english_only(source, path)`
  - `check_docstrings` (function, line 249) `def check_docstrings(source, path)`
  - `check_no_hardcoded_paths_or_ips` (function, line 290) `def check_no_hardcoded_paths_or_ips(source, path)`
  - `check_magic_numbers` (function, line 324) `def check_magic_numbers(source, path, allow)`
  - `check_source` (function, line 359) `def check_source(source, path, allow_numbers)`
  - `check_markdown` (function, line 372) `def check_markdown(content, path)`
  - `check_spec` (function, line 381) `def check_spec(spec, min_sad_paths)`
  - `__init__` (method, line 60) `def __init__(self, start, text)`
  - `start` (method, line 65) `def start(self)`
  - `group` (method, line 69) `def group(self, index)`
  - `finditer` (method, line 81) `def finditer(self, content)`
  - `passed` (method, line 107) `def passed(self)`
  - `blocks` (method, line 111) `def blocks(self)`
- Depends on: `core/hardening.py`, `skills/claude_md_orchestrator/models.py`
- Imported by: `skills/claude_md_orchestrator/bdd_agent.py`, `skills/claude_md_orchestrator/boy_scout.py`, `skills/claude_md_orchestrator/reviewer_agent.py`, `skills/claude_md_orchestrator/sdd_agent.py`, `skills/claude_md_orchestrator/tdd_agent.py`, `tests/test_security_alerts_fix.py`