本文へ移動
cccskills
無料GitHub で公開

structured-planning

Decompose multi-step work into a revisable subgoal plan with stable step IDs, checkpointing, and plan-ahead execution. Load when a task needs explicit planning before action, subgoal decomposition, plan checkpointing, or ReCAP-style plan-ahead execution. Also triggers on "structured plan", "plan with steps", "subgoal graph", "revise the plan", "checkpoint plan", or multi-step tasks where naive one-shot execution would be fragile. Skips trivial single-step tasks. Pairs with dynamic-routing on failure. Distinct from process-decomposer (registry/triage) and problem-to-plan (doc deliverables).

インストール方法を見る

含まれるファイル(5)

  • SKILL.md4.4 KB
  • references/examples.md646 B
  • references/PATTERNS.md1.8 KB
  • references/PLAN-SCHEMA.md1.6 KB
  • scripts/plan_lint.py3.3 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Structured Planning

You plan before you act: emit a subgoal checklist with stable ids (S1, S1.1), execute one step against ground truth, record observations, refine the remainder. On failure, hand off to dynamic-routing — do not blind-retry.

Hard Rules

Trivial tasks (single step, obvious outcome) → skip formal plan; state "trivial — plan skipped." Non-trivial tasks → write plan to .agent-loom/plans/<task-id>.md per references/PLAN-SCHEMA.md. Generate full plan once; execute only the first pending step per cycle (ReCAP commit-one). Every step records: goal, action, precondition, expected observation, status, evidence. Run scripts/plan_lint.py after each plan write. Append plan changes to Plan delta log with reason — never silent edits.


Workflow

Step 1 — Triage complexity

SignalRoute
Single tool call / one file / clear outcomeSkip plan — execute directly
Multi-step, failure-prone, or user asked to planContinue

Step 2 — Draft full plan

  1. Assign task_id slug and stable step ids.
  2. Fill all fields per PLAN-SCHEMA.
  3. Write file; run plan_lint.py.

Step 3 — Execute one step

  1. Mark step in-progress.
  2. Run the action; capture actual observation in evidence:.
  3. Mark done or failed.

Step 4 — Refine remainder

Before the next step: update preconditions/expected fields for pending steps using new evidence. Log deltas.

Step 5 — On failure

Invoke dynamic-routing with failed step id + evidence. Apply revised plan; lint again.

Step 6 — Complete

All steps done or explicit aborted. Emit final plan path.


Gotchas

  • Executing the whole plan without observation updates recreates one-shot fragility.
  • Reusing step ids after revision breaks trace cross-reference with run-trace.
  • Plans in chat only — not auditable; always persist to .agent-loom/plans/.

Output Format

## Structured plan — [task_id]

Plan file: `.agent-loom/plans/[task_id].md`
Steps: N total | done: N | pending: N | failed: N

Current step: **Sx** — [goal]
Observation: [actual vs expected]

Delta (if any): [step] [from→to] — [reason]

Next: execute **Sy** | invoke dynamic-routing | complete

Examples

Teaser: 4-step API feature → full plan written → S1 done (migration applied) → S2 preconditions updated after observing schema conflict.

Full pairs: references/examples.md


Common Rationalizations

ExcuseReality
"Planning is overhead"Rework from a failed one-shot costs more.
"I'll keep the plan in my head"Not handoff-safe; write the file.
"Execute all steps then fix"Violates commit-one; observations won't flow.
"process-decomposer already planned"That produces process entries; this is runtime execution state.
"problem-to-plan wrote a plan doc"docs/plans/ is spec; this is live execution tracking.

Verification

  • Plan file exists at .agent-loom/plans/<task-id>.md
  • plan_lint.py passes
  • Only one step executed per cycle
  • Delta log updated on revision

Red Flags

  • Multi-step work with no plan file
  • Failed step without delta log entry
  • Blind retry of same action after failure

Prune Log

Last pruned: 2026-07-05

  • Initial release from high-leverage skill spec (Skill 1 family)

Impact Report

Plan: [task_id] | Steps: N/M done | Lint: [pass/fail] | Current: [step id]

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Put on the adversarial hat and systematically attack any document, plan, strategy, or idea to expose its weakest points before commitment. Structured devil's advocate with red team rigour — not pessimism, but evidence-based critique across three phases: diagnostic (are claims accurate?), creative (is the problem artificially constrained?), challenge (are solutions robust?). Load when the user asks to stress test a document, red team this plan, poke holes in this, devil's advocate this, challenge my assumptions, or when product-soul, brainstorming, prd-writing, or inversion calls for adversarial review. Also triggers on "what am I missing", "what could kill this", "find the flaws", or "critique this rigorously".

日本語の概要は準備中です。原文の説明を表示しています。

dvy1987/agent-loom32026年8月8日 更新

Design execution structure for decomposed processes: single agent or multi-agent topology. Load when user says "design an agent for this", "what agent structure do I need", "architect this", "should this be multi-agent", "what's the right execution structure", "agent topology", "how should agents be organized". Takes process-decomposer output as primary input. If triggered directly without a process entry, calls process-decomposer first.

日本語の概要は準備中です。原文の説明を表示しています。

dvy1987/agent-loom32026年8月8日 更新

Internal skill. Called by setup-evaluation after a PASS. Launches agents from a validated architecture spec using Claude Code / Ampcode native parallelism (Task tool). Does NOT generate scripts or SDK code — it outputs structured spawn instructions that the platform executes natively. Never invoked directly by the user. Never launches without a setup-evaluation PASS.

日本語の概要は準備中です。原文の説明を表示しています。

dvy1987/agent-loom32026年8月8日 更新

Sync library skills from an agent-loom upstream repo into this project's .agents/skills while preserving project-local and forked skills. Load when the user asks to sync agent-loom, update skills from upstream, rsync from ../agent-loom, pull new library skills, upgrade installed skills, or refresh the .agents folder without losing custom project skills. Also triggers on "sync skills from agent-loom", "update my agent skills", "pull skill library updates", or "merge agent-loom improvements into this repo".

日本語の概要は準備中です。原文の説明を表示しています。

dvy1987/agent-loom32026年8月8日 更新

Instrument a shipped product's AI agents with tracing and observability so you can see what they did, why outputs happened, and what each run cost. Plain-language primer plus free-tier-first backend selection (Langfuse, Phoenix, LangSmith, Braintrust) and OpenTelemetry/OpenInference instrumentation. Load when the user asks to add observability, add tracing, instrument my agents, see what my agent is doing in production, set up Langfuse or Phoenix or LangSmith, debug why my agent gave a bad answer, or track LLM cost per request. Also fires when agent-system-architecture or setup-evaluation requires an observability plan for an agent-chain product. NOT for tracing the coding agent itself — that is run-trace. Precondition for runtime-learning-loop.

日本語の概要は準備中です。原文の説明を表示しています。

dvy1987/agent-loom32026年8月8日 更新

Run a structured retrospective after development-phase runs of your product's agents — interview the owner in plain language about what went well and poorly, draft ranked improvement hypotheses, then design and run small n=1/n=2 experiments with pre-declared success criteria, guardrails, stop conditions, and a cost/ROI kill-switch. Load when the user says how did that run go, retro this run, the agent output was bad, what should we improve, draft hypotheses, run a small experiment, or after repeated dev runs of an agentic system produce uneven quality. Priority: output quality over performance over cost, each with diminishing-returns stops. NOT a product A/B test (experimentation), NOT coding-agent harness repair (harness-evolution), NOT production-scale learning (runtime-learning-loop).

日本語の概要は準備中です。原文の説明を表示しています。

dvy1987/agent-loom32026年8月8日 更新

dvy1987 のスキルをすべて見る

このスキルの問題を報告する