specflow-deep-onboardlisted

Deep onboarding for codebases where confidence matters. Orchestrates 3 parallel specflow-onboard-codebase passes by spawning separate subagents via the Agent tool, then reads their outputs from disk, compares structurally, investigates disagreements with focused agents, and produces a final merged spec tree. This skill runs in the main Claude Code session (which has access to the Agent tool) — it must NOT be invoked as a subagent itself. For a quick single-pass onboarding, use specflow-onboard-codebase directly instead. Trigger on: "deep onboard", "high-confidence onboarding", "run 3 passes", "multi-pass onboarding", "I need confident specs for this codebase".
pedropacheco95/cortex · ★ 1 · Testing & QA · score 74

Install: claude install-skill pedropacheco95/cortex

# Specflow: Deep Onboarding Orchestrate 3 parallel specflow-onboard-codebase passes, compare their outputs, investigate disagreements, and produce a final merged spec tree with high confidence. ## Why This Is a Skill, Not an Agent This orchestration requires spawning subagents via the Agent tool. The Agent tool is available to the main Claude Code session but may not be available inside a subagent. By running as a skill (instructions to the main session), the orchestrator always has access to the Agent tool. ## Cortex Awareness When the project has a `.cortex/` directory: - **Insight-first input (design §8.4 bridge 5).** Each pass inherits specflow-onboard-codebase's insight-first behaviour: passes build from the insight per-file entries (`.cortex/insight/anatomy/<path>.md`) and `.cortex/insight/graph.json` instead of re-walking the tree. - **Pulse output homes (design §8.5).** The transient process outputs live under `.cortex/pulse/`: write `onboarding-scratch/` (the `atoms/` and `pass-{a,b,c}/` directories) to `.cortex/pulse/onboarding-scratch/`, `deep-onboard-report.md` to `.cortex/pulse/deep-onboard-report.md`, and `proposed-notes.md` / `corrections.md` to `.cortex/pulse/`. Substitute these homes wherever the instructions below name the project-root equivalents. On a non-Cortex project the root paths below stand as-is. - **Bug findings live in the ledger, never `bugs.md` files.** Each pass files its bugs as ledger files (`compass/bugs/B-NNN-<slug>.