agentleFS
ElguajoElguajo/Progressive-Context-Kit/.claude/skills/implementation-execution/SKILL.md

implementation-execution

Skill0 starsChanged 41 days agoMITView on GitHub

Non-trivial implementation after direction is clear, including feature work and complete bug-fix execution.

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 3 are distinctive, and 2 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.

  • 2

    Very specific

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

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

    Before a meaningful execution target, select/create its Phase-owned task prompt archive record using docs/system/HANDOFF_PROTOCOL.md and …

    line 11
  2. Distinctive:

    Before the first execution/build step, when several required runtime, dependency, compiler, or tool prerequisites are already knowable, …

    line 38
  3. Distinctive:

    Treat polling as a costed execution step.

    line 44
  4. Distinctive:

    When an approved implementation plan contains genuinely independent tasks and the active harness explicitly permits child work, an isolated …

    line 52
  5. Very specific:

    After implementation, apply docs/system/QUALITY_PROTOCOL.md exactly.

    line 68

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

Implementation Execution

Before a meaningful execution target, select/create its Phase-owned task prompt archive record using docs/system/HANDOFF_PROTOCOL.md and check applicability using docs/system/CONTEXT_PROTOCOL.md. Preserve the request/prompt after use, execute only the unresolved portion, and keep observed evidence with its ID. Load only the execution view; within an already-grounded session use context_compile.py --task-only rather than repeating the full bundle. Original requests and accumulated evidence stay cold. Do not create records for routine mechanical substeps or uninitialized Framework Source maintenance.

Once direction is clear, implement end-to-end in one cohesive pass. Approval is for the chosen direction, not incomplete core-logic fragments.

A complete change includes required integration, imports, types, schemas, configuration, critical edge cases/error handling, backward compatibility unless approved otherwise, and relevant tests. Leave no debug output, dead code, placeholders, pseudo-code, or unnecessary dependencies. Follow repository conventions and avoid unrelated changes.

Testing

Tests follow behavior. Behavior changes and bug fixes require relevant tests when meaningfully testable. Prefer a regression test reproducing the original defect. Do not add a test framework for trivial/mechanical work. For substantial functionality, critical behavior, regression-prone logic, or a growing project, a lightweight development-only framework may be added autonomously when repository evidence supports it and it does not materially expand scope, complexity, maintenance, or production dependencies; otherwise route the choice through the decision workflow. If automated testing is impractical, verify the strongest available evidence and state the remaining uncertainty.

Before the first execution/build step, when several required runtime, dependency, compiler, or tool prerequisites are already knowable, check them in one grouped probe instead of discovering them one failure at a time. Resolve only confirmed missing prerequisites and respect existing dependency/approval policy; do not install speculative packages or turn a small task into environment setup. A later probe is justified only by new evidence from the first execution.

Treat polling as a costed execution step. If a command is still running and the harness returns control, wait in coarse intervals appropriate to expected duration — normally at least 30 seconds for builds/test suites — instead of repeated short polls. Do not send empty/no-op input only to peek, and do not poll when the execution call already blocks until completion. Poll sooner only when the command is expected to finish quickly or new evidence makes it useful.

Task-scoped coordination

When an approved implementation plan contains genuinely independent tasks and the active harness explicitly permits child work, an isolated task context may be used only when the essential task context can be captured in a minimal file-based brief. Give the worker the relevant interfaces and acceptance criteria, and a path for its concise evidence report. Keep task artifacts transient: they are not canonical project state.

For substantial tasks, independently assess requirement compliance and code quality after fresh verification. A narrow fix gets a scoped re-review of the finding and its fix; it does not require repeating a whole-task review without new risk. Batch only independent same-shape microtasks that share one clear implementation and review surface. Do not mandate a particular worktree, workspace, ledger, model, or subagent implementation when native project workflow is sufficient.

For bug fixes: root cause → reproduce when practical → smallest complete fix → regression test when supported → adjacent-behavior verification. Use systematic-debugging when cause is unclear rather than guessing.

After implementation, apply docs/system/QUALITY_PROTOCOL.md exactly. Do not mark work complete before required evidence is reconciled with acceptance criteria.

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.