agentleFS
a-lottesa-lottes/aSPARK/skills/increment/SKILL.md

increment

Skill25 starsChanged 3 months agoMITView on GitHub

Start the Act phase of the SPARK loop: build the increment strictly following the approved plan, task by task, with progress tracked in the plan. Use after the plan is approved, or to fix findings that came back from /peer-review or /demo-day.

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    1. scrypster/muninndb★ 332same 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 repository12 other files it gives its agents.

The file

We split this skill into the rules it gives an agent

7 rules. About 0 are common, 3 are distinctive, and 4 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 4

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    verify its definition of done — actually verify it (run the test, hit the endpoint, render the page), don't assert it.

    line 39
  2. Distinctive:

    write the tests the test strategy assigns to this task.

    line 41
  3. Distinctive:

    Stay inside the plan: If a task turns out wrong, impossible or missing:

    line 43
  4. Very specific:

    Fix-mode: When invoked to fix findings from /peer-review or /demo-day: read the report's Handoff block first — it names the open …

    line 50
  5. Very specific:

    Close the phase: All tasks done, full test suite green, project builds.

    line 64
  6. Very specific:

    No scope creep: features not in the plan don't get built, "while I'm here" improvements don't happen.

    line 70
  7. Very specific:

    Never mark a task done with a failing or unwritten DoD check.

    line 72

≈ “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

/increment — Act (Developer)

You are running the Act ceremony — and this time you are the team member: the developer. No delegation; you build the increment yourself, in this conversation, so the user can watch and steer.

Input

Optional argument: the feature name. Resolve as usual.

Steps

  1. Check the gate. .spark/<feature-name>/plan.md must exist with status approved. If not, STOP and point to /sprint-plan.
  2. Load the working set — not the whole files. From plan.md: §1 Architecture Decision, §2 Affected Components, §3 Task Breakdown, §4 Test Strategy. From spec.md: §4 User Stories with their ACs, §5 Non-Functional Requirements, §6 Out of Scope. That is your backlog, your definition of correct, and your scope fence. The rest — personas, assumptions, the clarification log, the design review, the risk table — is material the Plan phase already consumed and turned into tasks; re-reading it here buys nothing and costs the context that the tasks themselves need. Pull a further section only when a task actually calls for it. The plan is your backlog — the task table top to bottom, dependencies respected.
  3. Work task by task. For each task:
    • set its Status to doing in the plan's task table;
    • implement it following the architecture decision and the codebase's existing conventions;
    • verify its definition of done — actually verify it (run the test, hit the endpoint, render the page), don't assert it;
    • write the tests the test strategy assigns to this task;
    • set Status to done and give the user a one-line progress note.
  4. Stay inside the plan. If a task turns out wrong, impossible or missing:
    • small, obvious correction → do it and record the deviation in a Deviations note appended to the plan;
    • anything that changes architecture, scope or stories → STOP and offer /sprint-plan (revision) or /story-time. You do not improvise architecture — that's the whole point of aSPARK.
  5. Fix-mode. When invoked to fix findings from /peer-review or /demo-day: read the report's Handoff block first — it names the open Blocker/Major IDs, which is your task list; read the Findings / Exploratory Findings table by exception, for the rows the block points at, not the whole report. Fix each, and re-run the affected tests. You are not that report's owner and never bump its Round field — that is the owner's call, made at the start of its own re-review/re-test pass, not yours to guess. In the same edit: overwrite the finding's Status cell to exactly fixed — no round number, since you don't know which round will confirm it — and overwrite the Handoff block in place with the new state — never append a round, the block holds one current state. Create no new section and no "Fixes applied" heading; the fixed row, in place, is the record. A stale block left behind after your edit is a defect, not a cosmetic issue.
  6. Close the phase. All tasks done, full test suite green, project builds. Report to the user: tasks completed, deviations recorded, test results.

Rules

  • No scope creep: features not in the plan don't get built, "while I'm here" improvements don't happen. Park ideas for the next /story-time.
  • Never mark a task done with a failing or unwritten DoD check.
  • Match the codebase's existing style, structure and idioms.

Handoff

  • Increment complete → /peer-review
  • Came from fix-mode → back to the phase that sent you (/peer-review re-review or /demo-day re-test)

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.