Skip to content
OpenSmartRoute
Skillv1.0.0

doc-iplan-autopilot

Generate IPLANs end-to-end from a SPEC/TDD, a prompt, or an existing IPLAN - detect input, plan a test-first file manifest, generate, validate, and run the audit/fix cycle. Use to create or batch-crea

by vladm3105(0) 0 installs
Free
Sign in to install

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

Imported from vladm3105/aidoc-flow-framework (platforms/claude-code-plugin/skills/doc-iplan-autopilot/SKILL.md). Install upstream with npx skills add vladm3105/aidoc-flow-framework --skill doc-iplan-autopilot. Copyright stays with the author.

doc-iplan-autopilot

Purpose

Automated IPLAN generation pipeline. From a SPEC/TDD component, a user prompt, or an existing IPLAN, it analyzes the source, plans a test-first file manifest, generates a complete IPLAN, validates CODE-readiness, maintains IPLAN-00_index.yaml, and drives the audit↔fix cycle to a passing score — for one IPLAN or a batch.

Layer: 8 (final doc layer; downstream is Code). Upstream: SPEC/TDD, prompt, or existing IPLAN input. Downstream: a validated IPLAN + index entry.

This autopilot generates permanent IPLANs only (one per SPEC/TDD component). Temporary bugfix plans are authored manually via ../doc-iplan/SKILL.md and are not registered in the index.

Skill Dependencies

Skill Role
../doc-iplan/SKILL.md IPLAN structure and authoring rules (generation)
../doc-iplan-audit/SKILL.md quality gate (CODE-Ready scoring + findings)
../doc-iplan-fixer/SKILL.md applies fixes from the audit report
../doc-naming/SKILL.md document/element-ID standards

Input Contract

Accepts: a target IPLAN id/path; a SPEC or TDD id/path; a free-text prompt; or an existing IPLAN path. Precedence: explicit IPLAN > SPEC/TDD upstream > prompt. Optional: score threshold (default 90), max fix iterations (default 3), batch list. With no explicit input, treat the request as a prompt.

Smart Document Detection

For each target, check whether the IPLAN already exists (docs/08_IPLAN/IPLAN-NN_*.yaml):

  • Missing → generate mode (from the SPEC/TDD component).
  • Exists → review & fix mode (audit, then fix if below threshold).

A SPEC-NN or TDD-NN input maps to its IPLAN-NN; generate if missing, otherwise review. Determine plan type (permanent vs temporary) from the source — this autopilot proceeds only for permanent plans.

Model precheck

Advisory, best-effort. Surfaces the model you recommended for this layer; it cannot switch the session model. Before invoking the driver:

  1. If .claude/aidoc-flow.config.yaml is absent, or has no model.* keys, skip this section entirely (no output).
  2. Resolve the recommended model: model.per_layer.IPLAN if set, else model.default.
  3. Act on model.precheck (warn | silent | block):
    • warn (default) — print one line, then continue to the driver: ℹ IPLAN recommends model '<rec>'. If you're not on it, run /model <rec> (or set model.precheck: silent to hide this).
    • silent — print nothing; continue.
    • block — print the line above plus precheck=block: confirm you want to draft on the current model, or run /model <rec> first., then wait for the user to confirm before continuing.

Workflow

Saga-driven generation loop (review_mode: team)

Step 1 — Invoke the driver. Period. The harness sets PREV_OUTPUT, ARTIFACT_ID, ARTIFACT_PATH env vars before invoking this SKILL. Your first orchestration action MUST be the Bash tool (the Model precheck above runs first), running exactly:

python3 "${CLAUDE_PLUGIN_ROOT}/tools/saga_driver.py" \
  --layer 08_IPLAN \
  --allow-skip-permissions

--allow-skip-permissions lets the phases the driver dispatches write files without a permission prompt — unattended autopilot requires it. Drop the flag to run the same loop with Claude Code's normal prompts on.

Use a generous timeout (≥1800s). Do not pre-analyze the input. Do not read the upstream. Do not classify type/scope. The driver and its dispatched subprocesses (/aidoc-flow:doc-iplan for draft, /aidoc-flow:doc-iplan-audit for review, /aidoc-flow:doc-iplan-fixer for fixer) handle all of that. The driver enforces the state machine preemptively per ${CLAUDE_PLUGIN_ROOT}/framework/governance/REVIEW_SAGA.md; this SKILL's job is to invoke it and report.

Step 2 — After the driver returns, report. Read .aidoc/review/08_IPLAN/${ARTIFACT_ID}/saga.json. Final status MUST be one of CLOSED (PASS), ESCALATED (terminal FAIL), or PARTIAL_TIMEOUT (soft-deadline; resumable). Print the status, the final score from verdict.json if present, and a 1-line summary.

Step 3 — Index update (only on CLOSED). Add a row to docs/08_IPLAN/IPLAN-00_index.yaml referencing the new IPLAN; update the upstream artifact's downstream entry.

That is the entire workflow in team mode. If you find yourself doing anything else here — drafting prose, dispatching Task subagents, invoking other slash commands — STOP, recognize that you are bypassing the driver, and invoke the Bash command above instead.

Linear Pipeline (review_mode: single_pass)

Unchanged legacy behaviour — used when the profile says so, when Task subagent dispatch is unavailable, or at write-time (on_author) where cost is the primary concern. The 5-step in-session pattern below produces the IPLAN without saga.json; the harness's saga-journal check will then fail the layer, so this mode is only appropriate for manual dry-runs.

  1. Input analysis — classify the input (SPEC/TDD / prompt / existing IPLAN), locate the upstream component, and decide generate vs review-and-fix.
  2. Manifest planning — verify the source TDD/SPEC is IPLAN-Ready ≥ threshold; plan the test-first file order and identify file dependencies; reserve the next IPLAN-NN.
  3. Generation — produce the IPLAN per ../doc-iplan/SKILL.md: Document Control first, all 6 sections, test-first file manifest, execution commands, implementation contracts when 3+ files share interfaces, an empty session handoff (sessions: []), cumulative tags (@brd @prd @ears @bdd @adr @spec @tdd), and a code_inventory seeded planned (one entry per manifest path). Diagrams via ../charts-flow/SKILL.md.
  4. Validation — run ../doc-iplan-audit/SKILL.md from scratch.
  5. Audit ↔ fix cycle — while score < threshold and iterations < max: run ../doc-iplan-fixer/SKILL.md, then re-audit. On pass, update docs/08_IPLAN/IPLAN-00_index.yaml; on exhausting iterations, flag for manual review.

Execution Modes

  • Single — one IPLAN (generate or review-and-fix).
  • Batch — multiple IPLANs, processed in chunks of 3 to bound context; generate plans for upstream components before dependent ones.
  • Dry-run — report the planned actions (type, file manifest, IDs) without writing files.

Quality Gates

  • Generation does not complete until the audit passes (CODE-Ready ≥ threshold, 0 Tier-1 errors) or the iteration cap is hit (then: manual-review flag).
  • The IPLAN index is updated only after a plan passes.
  • Fresh audit every cycle — no cached scores.

Error Handling

Situation Action
Source SPEC/TDD below IPLAN-Ready threshold stop; report the upstream gap (fix upstream first)
Max iterations reached below threshold write reports, flag for manual review, continue batch
Source input ambiguous fall back to prompt mode; record assumptions in the IPLAN
Write/permission error log, skip the item, continue the batch

Adaptation

Before applying defaults, read the project adaptation profile (.aidoc/profile.yaml) and apply it in both the generation and the internal audit/fix phases. Honor section_toggles, active_layers, audit_threshold (raise-only — stricter only), and glossary. Ignore any unknown or out-of-surface key; absent a profile, use framework defaults. Authority: ${CLAUDE_PLUGIN_ROOT}/framework/governance/ADAPTATION.md.

Related Resources

  • Create: ../doc-iplan/SKILL.md · Audit: ../doc-iplan-audit/SKILL.md · Fix: ../doc-iplan-fixer/SKILL.md
  • Authority: ${CLAUDE_PLUGIN_ROOT}/framework/layers/08_IPLAN/IPLAN-TEMPLATE.yaml, ${CLAUDE_PLUGIN_ROOT}/framework/layers/08_IPLAN/README.md, ${CLAUDE_PLUGIN_ROOT}/framework/layers/08_IPLAN/IPLAN-00_index.TEMPLATE.yaml

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml
targets:
  - https://api.opensmartroute.ai/api/v1/registry/vladm3105-aidoc-flow-framework-doc-iplan-autopilot/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

vladm3105-aidoc-flow-framework-doc-iplan-autopilot.ocm.jsonjson
{
  "ocm": "1",
  "id": "vladm3105-aidoc-flow-framework-doc-iplan-autopilot",
  "kind": "skill",
  "name": "doc-iplan-autopilot",
  "description": "Generate IPLANs end-to-end from a SPEC/TDD, a prompt, or an existing IPLAN - detect input, plan a test-first file manifest, generate, validate, and run the audit/fix cycle. Use to create or batch-create IPLANs.",
  "publisher": "vladm3105",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "sdd-workflow",
      "layer-8-artifact",
      "automation-workflow",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Generate IPLANs end-to-end from a SPEC/TDD, a prompt, or an existing IPLAN - detect input, plan a test-first file manifest, generate, validate, and run the audit/fix cycle. Use to create or batch-create IPLANs."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/vladm3105/aidoc-flow-framework",
      "path": "platforms/claude-code-plugin/skills/doc-iplan-autopilot/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/vladm3105/aidoc-flow-framework/blob/HEAD/platforms/claude-code-plugin/skills/doc-iplan-autopilot/SKILL.md",
      "key": "vladm3105/aidoc-flow-framework/platforms/claude-code-plugin/skills/doc-iplan-autopilot/SKILL.md"
    }
  },
  "instructions": "# doc-iplan-autopilot\n\n## Purpose\n\nAutomated **IPLAN generation pipeline**. From a SPEC/TDD component, a user\nprompt, or an existing IPLAN, it analyzes the source, plans a test-first file\nmanifest, generates a complete IPLAN, validates CODE-readiness, maintains\n`IPLAN-00_index.yaml`, and drives the audit↔fix cycle to a passing score — for\none IPLAN or a batch.\n\n**Layer**: 8 (final doc layer; downstream is Code). **Upstream**: SPEC/TDD,\nprompt, or existing IPLAN input. **Downstream**: a validated IPLAN + index entry.\n\nThis autopilot generates **permanent** IPLANs only (one per SPEC/TDD componen",
  "cost": {
    "context_tokens": 1964
  }
}

Fetch it by URL: GET /api/v1/registry/vladm3105-aidoc-flow-framework-doc-iplan-autopilot/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.