agentleFS
usibuildsusibuilds/claude-context-zones/skills/feature-builder/SKILL.md

feature-builder

Skill0 starsChanged 12 days agoMITView on GitHub

Build software or automations with "top-down plan, bottom-up build" — a short PLAN.md spec first, then one tested feature per chat, ending with a FEATURE COMPLETE notice and a handoff for the next chat. Use when the user plans a project, asks for the next feature, or builds an app, website or workflow step by step.

3 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions3 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 3

    1. IdkwhatImD0ing/hackathonstarterkit★ 2same name
    2. ivanshchitov/tabletop-ai-assistant-tui★ 0same name
    3. vmatviichuk-epam/custom-skills★ 0same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository2 other files it gives its agents.

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 4 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    When there is no plan yet, or the user asks to plan:

    line 14
  2. Distinctive:

    Ask at most 3 questions (goal, users, must-have features) unless the answers are already known.

    line 15
  3. Very specific:

    Write a PLAN.md block (max ~120 lines):

    line 16
  4. Distinctive:

    When the user says "build F3" or "next feature":

    line 27
  5. Distinctive:

    Do not print FEATURE COMPLETE.

    line 47

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 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

Feature Builder — top-down plan, bottom-up build

Reply in the user's language. Keep code, commands, file names and the PLAN/HANDOFF blocks in English.

Idea: an architect draws the whole house first (top-down), then builders lay one tested brick course at a time (bottom-up). The plan stays small and lives in a file, so every new chat reads a 2–5K-token plan instead of a 100K-token chat history.

Mode A — Top-down: create or update the plan

When there is no plan yet, or the user asks to plan:

  1. Ask at most 3 questions (goal, users, must-have features) unless the answers are already known.
  2. Write a PLAN.md block (max ~120 lines):
    • Product in one line
    • Tech stack (fixed)
    • Core data / entities (bullets, no code)
    • Features as a checklist in build order: - [ ] **F1 Name** — one-line scope
    • Acceptance rule (what "done" means)
    • Decisions log
    • Later / Ideas (things we will NOT build now)
  3. Tell the user to save it as PLAN.md in the Project knowledge (chat apps) or docs/PLAN.md in the repo (coding tools).

Mode B — Bottom-up: build ONE feature

When the user says "build F3" or "next feature":

  1. Work only on that feature. Read only what it needs.
  2. First give a mini-plan: files/nodes to create or change, and acceptance tests — 3–6 checks written QA-style: input → expected result. Wait for the user's OK.
  3. Build in small steps. After each step, give the exact test to run or what to click.
  4. Anything that belongs to another feature → add it to "Later / Ideas"; do not build it now.

When all acceptance tests pass — FEATURE COMPLETE

Print exactly this notice:

✅ FEATURE COMPLETE: <F-number + name>
Tests passed: <list>
PLAN.md update: mark <F-number> as [x]
Next feature: <next unchecked F-number + name>
→ Copy the handoff below → new chat → paste → "next feature"

Then give a handoff block: goal, decisions, status, files, open bugs, next 3 steps.

If a test fails or the user hasn't tested yet

Do not print FEATURE COMPLETE. Fix, re-test, then print it.

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.