agentleFS
kaka-rutokaka-ruto/skills/continuous-development/SKILL.md

continuous-development

Skill4 starsChanged 7 months agoMITView on GitHub

Use when building, changing, or extending a software project so work stays continuous, prioritized, and consistent across sessions

The file

Show its rules and text

We split this skill into the rules it gives an agent

64 rules. About 0 are common, 39 are distinctive, and 25 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈39

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 25

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    When this skill is in use and PLAN.md has any unchecked items in Now, the agent should:

    line 21
  2. Distinctive:

    Only stop when one of these is true:

    line 24
  3. Distinctive:

    Do not report progress: Keep picking up the next top-most unchecked item and continue working without status updates.

    line 28
  4. Very specific:

    All items in PLAN.md Now are complete, or

    line 29
  5. Distinctive:

    If the answer to both is no, the agent must not stop (unless the human explicitly asks it to stop).

    line 35
  6. Very specific:

    Update PLAN.md (and MISSION.md/VISION.md if needed), then

    line 36
  7. Distinctive:

    CRITICAL: Never let PLAN.md Now become empty: When it becomes empty (all items completed), the agent MUST immediately:

    line 40
  8. Very specific:

    Update PLAN.md with these new tasks in the proper dependency order.

    line 43
  9. Very specific:

    Update MISSION.md to mark any changed statuses (move items to/from Now/Next/Later as appropriate).

    line 44
  10. Distinctive:

    Keep the work rolling without stopping—do not ask for new instructions, do not report "all done", do not wait for input.

    line 45
  11. Distinctive:

    After each completed slice:

    line 51
  12. Very specific:

    Update PLAN.md immediately (move the slice to Done (recent)).

    line 53
  13. Distinctive:

    Run targeted verification for the change (tests or the project's verification default).

    line 54
  14. Distinctive:

    Commit the completed slice using the repo's git workflow (one logical change per commit).

    line 55
  15. Distinctive:

    Always, when doing project work that changes behavior, adds features, refactors, fixes bugs, or updates docs.

    line 60
  16. Distinctive:

    Prefer clarity over completeness.

    line 73
  17. Distinctive:

    Avoid deep detail (no code, no file lists, no step-by-step tutorials).

    line 109
  18. Very specific:

    Do not put operating rules here.

    line 111
  19. Distinctive:

    Keep it concise and action-oriented.

    line 129
  20. Distinctive:

    Prefer stable defaults over exhaustive instructions.

    line 130
  21. Very specific:

    If any of VISION.md, MISSION.md, PLAN.md, or AGENTS.md is missing, create it.

    line 134
  22. Distinctive:

    Read repo context first (README, docs, existing runbooks, current product behavior, recent changes).

    line 145
  23. Distinctive:

    Ask the human to confirm: north star, scope boundaries, and the top items for Now.

    line 147
  24. Distinctive:

    After confirmation, keep the docs accurate as the work evolves.

    line 148
  25. Distinctive:

    MISSION.md: if it answers: "What capability or quality bar must become true?"

    line 161
  26. Distinctive:

    PLAN.md: if it answers: "What is the next smallest verifiable slice to do today?"

    line 162
  27. Distinctive:

    If an item is phrased like "Refactor…", "Clean up…", "Improve…", it usually belongs in PLAN only if it unblocks a VISION outcome.

    line 164
  28. Very specific:

    Before adding slices to PLAN.md, determine the dependency order (what must exist first).

    line 172
  29. Very specific:

    Keep MISSION.md and PLAN.md ordered so the top-most items are always the next to be picked (highest priority) and are not dependent on …

    line 173
  30. Distinctive:

    Prefer enabling primitives first, then building features on top, so each slice is completable when started.

    line 174
  31. Distinctive:

    Do not write slices that require unspecified "future work" to be complete.

    line 175
  32. Very specific:

    If ordering is unclear, collaborate with the human before expanding PLAN.md.

    line 176
  33. Very specific:

    Do not put a dependent capability into Mission Now if its prerequisites are not already done or explicitly listed above it in Mission Now.

    line 181
  34. Very specific:

    When a grand goal is blocked by missing foundations, rewrite Mission Now to focus on the missing foundations first.

    line 182
  35. Very specific:

    Read AGENTS.md, VISION.md, MISSION.md, and PLAN.md, then pick the first unchecked item in Now.

    line 188
  36. Very specific:

    If MISSION.md Now is empty, promote the highest-priority items from Mission Next into Mission Now.

    line 189
  37. Very specific:

    Ensure PLAN.md Now/Next/Later only contains slices that advance Mission Now.

    line 190
  38. Very specific:

    Update PLAN.md immediately: check the item, add the next slice if it became obvious, and keep caps enforced.

    line 192
  39. Very specific:

    If the slice changes capabilities/quality bars, update MISSION.md.

    line 193
  40. Distinctive:

    Silence rule: do not emit progress updates while executing this loop.

    line 195
  41. Very specific:

    Stop only for real blockers (missing access, unclear requirements that change behavior, unsafe operations requiring explicit approval) or …

    line 197
  42. Distinctive:

    Default caps (not hard limits):

    line 203
  43. Very specific:

    When Done (recent) exceeds 20, delete the oldest completed items from PLAN.md.

    line 210
  44. Distinctive:

    When Now grows too large to scan quickly, move overflow to Next.

    line 211
  45. Distinctive:

    Default cap (recommended, but flexible):

    line 217
  46. Distinctive:

    Remove outcomes that are fully delivered and no longer informative.

    line 223
  47. Distinctive:

    If quality bars are met and stable, keep only the bar statement (not the history).

    line 225
  48. Very specific:

    Keep Now stocked and ordered (aim for 10+).

    line 226
  49. Distinctive:

    Keep Now stocked and ordered (aim for 10+).

    line 234
  50. Distinctive:

    Keep items one-line and outcome-shaped.

    line 235
  51. Distinctive:

    Prefer grouping by short section headers (e.g., "Auth", "Billing", "Search") over letting lists become a wall of text.

    line 236
  52. Distinctive:

    If the same idea appears in multiple places, rewrite it once in the correct doc and delete duplicates.

    line 248
  53. Distinctive:

    Treat "the road expanded" as a productivity event: it is an opportunity to remove future confusion and keep momentum with the latest …

    line 265
  54. Distinctive:

    If new information changes what is true, update the relevant doc(s) so the next agent starts from reality.

    line 268
  55. Distinctive:

    Do not "keep going" on stale assumptions.

    line 269
  56. Very specific:

    If the change alters what the "next slice" should be, update MISSION.md/PLAN.md immediately before coding further.

    line 282
  57. Very specific:

    If the change alters what the project is, ask the human before editing VISION.md, then proceed with the clarified direction.

    line 283
  58. Distinctive:

    If you are working in a repo that expects commits, treat "slice done" as "ready to commit".

    line 294
  59. Distinctive:

    If committing is not explicitly requested, ask before committing, but still complete the slice and update the checklists.

    line 295
  60. Very specific:

    Always keep PLAN.md "Now" non-empty (or explicitly state the blocker).

    line 319
  61. Very specific:

    Always finish a work session by updating PLAN.md to reflect reality.

    line 320
  62. Distinctive:

    Never add deep instructions, code, or file listings to these docs.

    line 321
  63. Distinctive:

    Prefer revising existing items over adding duplicates.

    line 322
  64. Distinctive:

    Use these shapes (adapt wording per project).

    line 326

≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Continuous Development

Overview

This skill standardizes how agents keep a project moving over time, even when the agent/model changes. It does this by maintaining four lightweight, human-readable artifacts in the repo root: VISION.md (north star), MISSION.md (capability checklist), PLAN.md (current work queue), and AGENTS.md (durable operating rules for agents).

Core principle: the repo must always answer "what are we building?" and "what should I do next?" in under 2 minutes.

Contract (production-complete):

  • MISSION.md must be the complete capability list required to fulfill VISION.md in production (backend, frontend, UX, infra/config, security, performance, operations, and quality bars).
  • PLAN.md must be the complete set of slices required to complete MISSION.md Now in production. If a MISSION.md Now item has no corresponding PLAN.md Now slice, add the missing slice immediately before continuing.

Default Run Loop (Agent Autonomy)

When this skill is in use and PLAN.md has any unchecked items in Now, the agent should:

  1. Pick the top-most unchecked item in PLAN.md Now and start implementing it immediately.
  2. Only stop when one of these is true:
    • A hard blocker exists (missing credentials, missing infra, unknown requirement that cannot be inferred safely).
    • The next action would be high-risk or destructive (data loss, prod operations, irreversible changes) and requires explicit human approval.
    • A product decision is required that cannot be reasonably inferred from repo context.
  3. Do not report progress. Keep picking up the next top-most unchecked item and continue working without status updates. Only interrupt the human when:
    • All items in PLAN.md Now are complete, or
    • A hard blocker / high-risk gate / product decision is encountered. This is a strong default: avoid "here's what I'm doing" updates; keep executing.
  4. Before stopping or reporting, the agent must explicitly answer these two questions:
    • Are all PLAN.md Now items done?
    • Was a hard blocker / high-risk gate / product decision encountered? If the answer to both is no, the agent must not stop (unless the human explicitly asks it to stop). It must:
    • Update PLAN.md (and MISSION.md/VISION.md if needed), then
    • Immediately continue with the next top-most unchecked PLAN.md Now item. Emphasize this strongly: no quiet pauses, no "I'll wait" behavior, no progress reports—keep executing until completion or a real blocker.

CRITICAL: Never let PLAN.md Now become empty. When it becomes empty (all items completed), the agent MUST immediately:

  1. Bring in a sizable batch of new tasks from MISSION.md Now (or promote from Mission Next if needed).
  2. Update PLAN.md with these new tasks in the proper dependency order.
  3. Update MISSION.md to mark any changed statuses (move items to/from Now/Next/Later as appropriate).
  4. Keep the work rolling without stopping—do not ask for new instructions, do not report "all done", do not wait for input.

The goal is to finish the entire MISSION.md, not just to empty PLAN.md Now. Work continues until every capability in MISSION.md Now is complete and promoted to Done (recent).

CRITICAL: Keep MISSION.md complete. If you discover a missing prerequisite or capability needed to fulfill VISION.md, add it to MISSION.md in the correct dependency order (usually Next or Later unless it's a prerequisite for MISSION.md Now). Then keep PLAN.md aligned so it fully covers MISSION.md Now.

After each completed slice:

  • Update PLAN.md immediately (move the slice to Done (recent)).
  • Run targeted verification for the change (tests or the project's verification default).
  • Commit the completed slice using the repo's git workflow (one logical change per commit).
  • Immediately start the next top-most item in PLAN.md Now.

When to Use

  • Always, when doing project work that changes behavior, adds features, refactors, fixes bugs, or updates docs.
  • Especially when work is spread across multiple sessions and you want a consistent "what next" source of truth.

The Four Documents

VISION.md (North Star)

VISION.md is the narrative north star: what the product is, who it is for, and what "winning" means. It should be short and stable.

Rules:

  • No checklists.
  • Rarely edited; update only when direction changes.
  • Prefer clarity over completeness.

Recommended sections:

  • Purpose: 2–5 sentences
  • Audience: who it serves
  • Winning: what success looks like
  • Scope Boundaries: what the project will not do (short, explicit)

MISSION.md (Capability Checklist)

MISSION.md is a living checklist of product capabilities and quality bars. It can be edited and pruned as understanding changes.

Rules:

  • Items are outcomes/capabilities, not implementation steps.
  • Items should be stable enough to matter for weeks, not hours.
  • It is allowed to rewrite, split, merge, and reorder items.
  • Aim to keep at least 10 items in each of Now, Next, and Later sections. When there is more pending work, keep more. Only reduce below 10 when the entire project is complete and there is nothing left to work on.

Recommended sections:

  • Now: capabilities to actively drive right now
  • Next: important capabilities that are queued but not active
  • Later: capabilities intentionally deferred
  • Done (recent): recently completed capabilities (prunable)
  • Quality Bars: performance, reliability, security, cost guardrails ([ ] ...)
  • Scope Boundaries: what the project will not do (short, explicit)

PLAN.md (Work Queue)

PLAN.md is the current queue of small slices that push VISION forward. It should always contain a clear "next thing to do".

Rules:

  • Items are one-line slices, written as outcomes.
  • Avoid deep detail (no code, no file lists, no step-by-step tutorials).
  • Each slice must be self-contained: completable, verifiable, and meaningfully "done" without hidden follow-up work.
  • Do not put operating rules here. PLAN.md is a prunable task board.
  • PLAN.md must only contain slices that advance items in MISSION.md Now. Do not pull work from Mission Next/Later.
  • Aim to keep at least 10 items in each of Now and Next sections. When there is more pending work, keep more. Only reduce below 10 when all MISSION.md Now items are complete and there is nothing left to work on.

Recommended sections:

  • Now: aim for 10+ items when MISSION Now has pending work
  • Next: queued items that are ready but not urgent (aim for 10+ when possible)
  • Later: ideas that are explicitly not committed
  • Done (recent): a small buffer of recently completed items (for continuity)

AGENTS.md (Operating Rules)

AGENTS.md is the durable operating system for agents working in the repo. It should contain how to work, how to verify, and how to keep VISION.md/MISSION.md/PLAN.md accurate and clean.

Rules:

  • This is where process rules live.
  • Keep it concise and action-oriented.
  • Prefer stable defaults over exhaustive instructions.

Bootstrapping (If Docs Are Missing)

If any of VISION.md, MISSION.md, PLAN.md, or AGENTS.md is missing, create it. Bootstrap quickly from repo context, then collaborate with the human to confirm the intent and priorities.

Order:

  1. AGENTS.md (so agents know how to operate)
  2. VISION.md (north star)
  3. MISSION.md (capability checklist)
  4. PLAN.md (current slices)

Process:

  • Read repo context first (README, docs, existing runbooks, current product behavior, recent changes).
  • Draft minimal versions using the templates in this skill.
  • Ask the human to confirm: north star, scope boundaries, and the top items for Now.
  • After confirmation, keep the docs accurate as the work evolves.

Minimum viable bootstraps:

  • VISION.md: 5–15 lines, narrative only.
  • MISSION.md: 10–30 checkboxes to start; merge/split later.
  • PLAN.md: at least 1 item in Now (or an explicit blocker).
  • AGENTS.md: how to run/verify, how to update/prune the docs, and stop/ask rules.

Grand vs Immediate (The Placement Test)

Decide where an item belongs using these tests:

  • MISSION.md if it answers: "What capability or quality bar must become true?"
  • PLAN.md if it answers: "What is the next smallest verifiable slice to do today?"

If an item is phrased like "Refactor…", "Clean up…", "Improve…", it usually belongs in PLAN only if it unblocks a VISION outcome. Otherwise, it does not belong.

Bottoms-Up Planning (Dependency Order First)

Plan work bottoms up to avoid broken dependencies and half-done slices.

Rules:

  • Before adding slices to PLAN.md, determine the dependency order (what must exist first).
  • Keep MISSION.md and PLAN.md ordered so the top-most items are always the next to be picked (highest priority) and are not dependent on unfinished work below.
  • Prefer enabling primitives first, then building features on top, so each slice is completable when started.
  • Do not write slices that require unspecified "future work" to be complete. If a prerequisite is missing, make that prerequisite the first slice.
  • If ordering is unclear, collaborate with the human before expanding PLAN.md.

MISSION.md is also bottoms up:

  • Order capabilities so prerequisites come before dependents within Now and Next.
  • Do not put a dependent capability into Mission Now if its prerequisites are not already done or explicitly listed above it in Mission Now.
  • When a grand goal is blocked by missing foundations, rewrite Mission Now to focus on the missing foundations first.

The Continuous Loop (Always Running)

Repeat until blocked:

  1. Read AGENTS.md, VISION.md, MISSION.md, and PLAN.md, then pick the first unchecked item in Now.
  2. If MISSION.md Now is empty, promote the highest-priority items from Mission Next into Mission Now.
  3. Ensure PLAN.md Now/Next/Later only contains slices that advance Mission Now. If PLAN.md contains work for Mission Next/Later, move or delete it.
  4. Work the smallest slice to completion.
  5. Update PLAN.md immediately: check the item, add the next slice if it became obvious, and keep caps enforced.
  6. If the slice changes capabilities/quality bars, update MISSION.md. If it changes direction, update VISION.md.

Silence rule: do not emit progress updates while executing this loop. Keep going autonomously and continuously.

Stop only for real blockers (missing access, unclear requirements that change behavior, unsafe operations requiring explicit approval) or when PLAN.md Now is fully complete.

Caps and Pruning (Keep Docs Clean)

PLAN pruning rules (no separate done log)

Default caps (not hard limits):

  • Now: aim for >= 10 items while MISSION.md Now has pending work (use Next to park overflow)
  • Done (recent): aim for <= 20 items to preserve quick continuity

Pruning policy:

  • When Done (recent) exceeds 20, delete the oldest completed items from PLAN.md.
  • When Now grows too large to scan quickly, move overflow to Next.

Rationale: checked items are preserved in git history; the live docs must stay readable.

MISSION pruning rules

Default cap (recommended, but flexible):

  • Total checkboxes in MISSION.md: aim for <= 50, but allow more if they stay high-signal and well-organized

Pruning policy:

  • Remove outcomes that are fully delivered and no longer informative.
  • Merge overlapping outcomes into a single clearer one.
  • If quality bars are met and stable, keep only the bar statement (not the history).
  • Keep Now stocked and ordered (aim for 10+); park deferred capabilities in Next and Later.

Large Backlogs Without Noise

It is acceptable for MISSION.md and PLAN.md to contain many items if needed. The constraint is not item count; it is scanability.

Rules:

  • Keep Now stocked and ordered (aim for 10+); put overflow in Next and Later.
  • Keep items one-line and outcome-shaped.
  • Prefer grouping by short section headers (e.g., "Auth", "Billing", "Search") over letting lists become a wall of text.
  • Prune completed or superseded items aggressively to prevent noise.

No Overlap or Duplication Between Docs

The four docs must not contain overlapping or duplicated information. Each doc has one job:

  • VISION.md: direction (north star narrative)
  • MISSION.md: capabilities and quality bars (checkboxes)
  • PLAN.md: current slices and status
  • AGENTS.md: operating rules for agents

If the same idea appears in multiple places, rewrite it once in the correct doc and delete duplicates. Prefer moving information over copying it.

Self-Describing Docs (Required)

Each of the four files must state what it is for at the top. Use a short "Purpose" section so new agents/humans orient quickly.

Minimum:

  • VISION.md: ## Purpose (north star narrative)
  • MISSION.md: ## Purpose (capability and quality-bar checklist)
  • PLAN.md: ## Purpose (current slices and status)
  • AGENTS.md: ## Purpose (agent operating rules)

When The Road Expands (New Information)

This is normal and frequent. During development, the road will expand: hidden requirements, constraints, edge cases, unknown dependencies, new stakeholder expectations, or better ways to frame the work will appear mid-flight. This is not an exception case, it is the default reality of building.

Treat "the road expanded" as a productivity event: it is an opportunity to remove future confusion and keep momentum with the latest information.

Rule:

  • If new information changes what is true, update the relevant doc(s) so the next agent starts from reality.
  • Do not "keep going" on stale assumptions. Keep going by updating the system first (small) or proposing the change (major), then proceed using the updated truth.

Small vs major change gate:

  • Small change (implement immediately): clarifies wording, splits/merges checklist items, reorders bottoms-up dependencies, adds/removes a few slices, or tightens a scope boundary without changing direction.
  • Major change (propose first to the human): changes the north star, meaningfully expands scope, introduces a new major subsystem, changes priorities across domains, or adds new operating rules that affect how work is done.

Where to record new information:

  • Direction change: VISION.md
  • Capability/quality change: MISSION.md
  • Work sequencing change: PLAN.md
  • Operating/process change: AGENTS.md

Practical rule of thumb:

  • If the change alters what the "next slice" should be, update MISSION.md/PLAN.md immediately before coding further.
  • If the change alters what the project is, ask the human before editing VISION.md, then proceed with the clarified direction.

"Done" Means Done (Slice Completion Standard)

A slice is only "done" when:

  • The outcome is achieved.
  • It has an explicit verification method (tests, a reproducible check, or a measurable signal).
  • PLAN.md reflects the new reality.
  • MISSION.md checklists reflect the new reality.

If you are working in a repo that expects commits, treat "slice done" as "ready to commit". If committing is not explicitly requested, ask before committing, but still complete the slice and update the checklists.

Writing Rules for Checklist Items

Checklist items must be:

  • Outcome-shaped: describes what becomes true, not how
  • Unambiguous: a new agent can interpret it the same way
  • Small enough (PLAN): can be completed without inventing requirements

Allowed phrasing examples:

  • MISSION: [ ] Users can export invoices as PDF
  • PLAN: [ ] Add invoice PDF export endpoint and UI entry point

Avoid:

  • VISION: [ ] Improve invoices
  • PLAN: [ ] Refactor billing code

Consistency Rules Across Agents

To reduce model variance, enforce these rules:

  • Always keep PLAN.md "Now" non-empty (or explicitly state the blocker).
  • Always finish a work session by updating PLAN.md to reflect reality.
  • Never add deep instructions, code, or file listings to these docs; keep them as coordination artifacts.
  • Prefer revising existing items over adding duplicates.

Minimal Templates

Use these shapes (adapt wording per project).

VISION.md

# Vision

## Purpose

North star narrative: what we are building, for whom, and what "winning" means.

## Purpose

...

## Audience

...

## Winning

...

## Scope Boundaries

...

MISSION.md

# Mission

## Purpose

Living checklist of capabilities and quality bars. The source of truth for "what must become true".

## Now

- [ ] ...

## Next

- [ ] ...

## Later

- [ ] ...

## Done (recent)

- [x] ...

## Quality Bars

- [ ] ...

## Scope Boundaries

- ...

PLAN.md

# Plan

## Purpose

Current work queue of slices. This is a prunable task board, not a place for operating rules.

## Now

- [ ] ...

## Next

- [ ] ...

## Later

- [ ] ...

## Done (recent)

- [x] ...

AGENTS.md

# Agent Operating Rules

## Purpose

Durable operating rules for agents: how to run, verify, update/prune the docs, and when to stop/ask.

- How to run the project locally.
- How to verify changes before calling work "done".
- How to update/prune `VISION.md`, `MISSION.md`, and `PLAN.md`.
- Stop/ask rules for risky or ambiguous work.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.