Plan

Skill MakFly/ai-dev-kit/.claude/skills/plan

Spec-Driven Agentic OS for Claude Code + OpenAI Codex CLI. Native skills, subagents, hooks, and an adversarial codex review loop. Inspired by github/spec-kit, built on Claude Code primitives. No daemon, no vendor lock-in.

Install

npx -y skills add MakFly/ai-dev-kit --skill plan

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use PROACTIVELY when the user invokes /plan <slug> or asks "how should we build this". Runs the `planner` subagent in a forked context which writes specs/<slug>/plan.md from a clarified spec. Refuses to plan if spec.md is still `draft`.

SKILL.md

1.7 KB, as published. Nobody here has run it

/plan

Author specs/<slug>/plan.md via the planner subagent.

Procedure

Read spec. cat specs/<slug>/spec.md. Refuse if missing or Status: draft.
Read constitution. Cross-check against principles before delegating.
Read digest. Check current versions of libs/tools in supports/digests/digest-*.md (≤ 7 days). Warn if stale.
Delegate. Invoke planner subagent with the spec slug.
Surface risks. When planner returns, print the §4 Risks table to chat. Highlight any Impact: high.
Commit. git commit -m "plan(<slug>): initial draft". Suggest /review <slug> plan for codex challenge before locking.

Doctrine

No code. Architecture, data flow, risks, alternatives, test strategy. Not function bodies.
Spec is law. Plan cannot widen scope vs spec §4 acceptance criteria. If you find yourself adding scope, stop and propose a spec amendment instead.
Risks are required. A plan with zero risks is incomplete.
Codex review before locking. Plan stays draft until codex review passes.

Pipeline position

/constitution → /specify → /clarify → /plan [YOU] → /tasks → /implement → /review