Skip to content
OpenSmartRoute
Skillv1.0.0

plan

Research codebase and create spec + phased implementation plan with file-level tasks

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

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

See reviews

About

Imported from fortunto2/rust-code (skills/plan/SKILL.md). Install upstream with npx skills add fortunto2/rust-code --skill plan. Copyright stays with the author.

WORKFLOW:

  1. READ CLAUDE.md + README.md — architecture, stack, constraints
  2. TREE root level=3 — understand project structure
  3. SEARCH for keywords from task description — find affected files
  4. READ existing plans — list("docs/plan") to check overlap
  5. GENERATE track ID: {shortname}_{YYYYMMDD} (kebab-case)
  6. WRITE docs/plan/{trackId}/spec.md: 
    # Specification: {Title}
**Track ID:** {trackId}
**Type:** Feature|Bug|Refactor|Chore
**Created:** {date}
## Summary — 1-2 paragraphs from research
## Acceptance Criteria — 3-8 concrete checkboxes
## Dependencies
## Out of Scope
## Technical Notes — architecture decisions, reusable code found
  7. WRITE docs/plan/{trackId}/plan.md: 
    # Implementation Plan: {Title}
**Spec:** [spec.md](./spec.md)
## Phase 1: {Name}
### Tasks
- [ ] Task 1.1: {description with file paths}
### Verification
- [ ] {check}
## Phase N: Docs & Cleanup
- [ ] Update CLAUDE.md
- [ ] Remove dead code
## Context Handoff
### Key Files — from research
### Decisions Made — why X over Y
### Risks
  8. UPDATE_PLAN with phases as steps (pending/in_progress/completed)
  9. FINISH with: "Track {trackId}: {N} phases, {N} tasks"

RULES:

  • Every task mentions specific FILE PATHS (from research, not guessed)
  • 5-15 tasks total across 2-4 phases
  • Last phase always "Docs & Cleanup"
  • Every acceptance criterion maps to at least one task
  • Tasks are atomic — one commit each

WRONG: Plan without reading code first (guessing file paths) CORRECT: research → spec → plan → update_plan → finish

EXAMPLE — Plan a new feature: Instruction: "plan adding WebSocket support"

  1. read("CLAUDE.md") → understand architecture
  2. tree("/", 3) → find relevant modules
  3. search("/", "websocket|ws|socket") → check existing code
  4. write("docs/plan/websocket-support_20260412/spec.md", ...)
  5. write("docs/plan/websocket-support_20260412/plan.md", ...)
  6. update_plan(plan: [{step: "Phase 1: Protocol", status: "pending"}, ...])
  7. finish("Track websocket-support_20260412: 3 phases, 8 tasks")

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/fortunto2-rust-code-plan/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.

fortunto2-rust-code-plan.ocm.jsonjson
{
  "ocm": "1",
  "id": "fortunto2-rust-code-plan",
  "kind": "skill",
  "name": "plan",
  "description": "Research codebase and create spec + phased implementation plan with file-level tasks",
  "publisher": "fortunto2",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "plan",
      "spec",
      "feature",
      "bug",
      "refactor",
      "implement",
      "design",
      "breakdown",
      "github"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Research codebase and create spec + phased implementation plan with file-level tasks"
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/fortunto2/rust-code",
      "path": "skills/plan/SKILL.md",
      "ref": "fcc91a93deb69fab3de2c96a32129cbd69beea72",
      "url": "https://github.com/fortunto2/rust-code/blob/fcc91a93deb69fab3de2c96a32129cbd69beea72/skills/plan/SKILL.md",
      "key": "fortunto2/rust-code/skills/plan/SKILL.md"
    }
  },
  "instructions": "WORKFLOW:\n  1. READ CLAUDE.md + README.md — architecture, stack, constraints\n  2. TREE root level=3 — understand project structure\n  3. SEARCH for keywords from task description — find affected files\n  4. READ existing plans — list(\"docs/plan\") to check overlap\n  5. GENERATE track ID: {shortname}_{YYYYMMDD} (kebab-case)\n  6. WRITE docs/plan/{trackId}/spec.md:\n     ```\n     # Specification: {Title}\n     **Track ID:** {trackId}\n     **Type:** Feature|Bug|Refactor|Chore\n     **Created:** {date}\n     ## Summary — 1-2 paragraphs from research\n     ## Acceptance Criteria — 3-8 concrete checkboxes\n  ",
  "cost": {
    "context_tokens": 546
  }
}

Fetch it by URL: GET /api/v1/registry/fortunto2-rust-code-plan/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.