JordanGunn/nunchuck / skills/plan/plan-create
plan-create
VerifiedCompile `.plan/active.yaml` into a schema-validated active plan directory under `.plan/active/`.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 714 B |
| assets/plan-discuss-artifact-schema.json | config | 4.6 KB |
| assets/plan-root-schema.json | config | 1.8 KB |
| assets/plan-subplan-schema.json | config | 1.4 KB |
| assets/plan-task-schema.json | config | 3.0 KB |
| references/00_ROUTER.md | markdown | 468 B |
| references/01_SUMMARY.md | markdown | 516 B |
| references/02_TRIGGERS.md | markdown | 554 B |
| references/03_ALWAYS.md | markdown | 487 B |
| references/04_NEVER.md | markdown | 260 B |
| references/05_PROCEDURE.md | markdown | 671 B |
| references/06_FAILURES.md | markdown | 484 B |
| scripts/include/plan_create_cli.py | script | 2.6 KB |
| scripts/include/plan_parse.py | script | 15.0 KB |
| scripts/skill.ps1 | script | 1.7 KB |
| scripts/skill.shexecutable | script | 1.5 KB |
scripts/include/plan_create_cli.py
View on GitHub#!/usr/bin/env python3
import argparse
import importlib.util
import sys
from plan_parse import ACTIVE_DIR, ACTIVE_INTENT_PATH, compile_active_plan, validate_active_plan
def cmd_help() -> int:
print(
"""plan-create - Compile .plan/active.yaml into .plan/active/
Usage:
plan-create [--force]
plan-create help
plan-create validate
Creates/overwrites:
.plan/active/plan.md
.plan/active/<letter>/index.md
.plan/active/<letter>/<roman>.md
Precondition:
.plan/active.yaml exists and is status: ready (use plan-discuss).
"""
)
return 0
def cmd_validate() -> int:
errors: list[str] = []
if importlib.util.find_spec("yaml") is None:
errors.append("missing dependency: pyyaml")
if importlib.util.find_spec("jsonschema") is None:
errors.append("missing dependency: jsonschema")
if errors:
for e in errors:
print(f"error: {e}", file=sys.stderr)
return 1
# Validate that required schemas are present (schema-first design).
from plan_parse import ROOT_SCHEMA_PATH, SUBPLAN_SCHEMA_PATH, TASK_SCHEMA_PATH
missing: list[str] = []
for p in [ROOT_SCHEMA_PATH, SUBPLAN_SCHEMA_PATH, TASK_SCHEMA_PATH]:
if not p.exists():
missing.append(str(p))
if missing:
for p in missing:
print(f"error: missing schema: {p}", file=sys.stderr)
return 1
print("ok: plan-create CLI is runnable")
return 0
def build_parser() -> argparse.ArgumentParser:
parser = argparse.ArgumentParser(prog="plan-create", add_help=False)
parser.add_argument("--force", action="store_true", help="Overwrite existing plan")
return parser
def main() -> int:
parser = build_parser()
args, unknown = parser.parse_known_args()
if unknown and unknown[0] == "help":
return cmd_help()
if unknown and unknown[0] == "validate":
return cmd_validate()
if not ACTIVE_INTENT_PATH.exists():
print(f"error: missing plan intent: {ACTIVE_INTENT_PATH}", file=sys.stderr)
print("run plan-discuss first", file=sys.stderr)
return 1
try:
out_dir = compile_active_plan(overwrite=args.force)
except ValueError as e:
print(f"error: {e}", file=sys.stderr)
return 1
errors = validate_active_plan()
if errors:
print(f"error: compiled plan failed validation ({len(errors)} issues)", file=sys.stderr)
for er in errors:
print(f" - {er}", file=sys.stderr)
return 1
print(f"created: {out_dir}")
print(f" {ACTIVE_DIR / 'plan.md'}")
return 0
if __name__ == "__main__":
sys.exit(main())
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |