agentleFS
Topaz1618Topaz1618/pawskills/skills/unfinished-work-tracking/SKILL.md

unfinished-work-tracking

Skill0 starsChanged 3 days agoMITView on GitHub

Unfinished work tracking standard. Requires recording requirements, defects, omissions, and items pending verification that are discovered during development but not yet resolved.

The file

Show its rules and text

We split this skill into the rules it gives an agent

13 rules. About 0 are common, 13 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈13

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Only part of a feature was completed.

    line 20
  2. Distinctive:

    If the project has no unified recording location, use TODO.md.

    line 40
  3. Distinctive:

    Do not build an unnecessarily complex task management system.

    line 52
  4. Distinctive:

    Check whether the current task involves any of them.

    line 59
  5. Distinctive:

    If they affect the correctness of the current task, resolve them first.

    line 61
  6. Distinctive:

    When a new item is discovered:

    line 65
  7. Distinctive:

    If it can be safely completed: complete it directly.

    line 67
  8. Distinctive:

    If it requires additional work: record it.

    line 68
  9. Distinctive:

    If it is temporarily impossible: record the reason.

    line 69
  10. Distinctive:

    If an existing item has been resolved: update its status.

    line 70
  11. Distinctive:

    If an old record turns out to be inaccurate: correct the record.

    line 71
  12. Distinctive:

    Only work that was actually completed may be marked as completed.

    line 88
  13. Distinctive:

    Not having told the user does not mean there are no outstanding items.

    line 98

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

Unfinished Work Tracking Standard

I. Core Principle

Any relevant work discovered during execution but not actually completed must be recorded.

Unfinished information must not be discarded merely because the current task ended, the context switched, or the user did not ask about it.

II. Situations That Require Recording

Include:

  • An explicit requirement that has not been implemented.
  • Only part of a feature was completed.
  • A gap was discovered in existing functionality.
  • A problem was discovered that needs fixing.
  • An interface was discovered that needs adjustment.
  • Documentation was discovered to be out of sync.
  • A matter was discovered that needs further investigation.
  • Something temporarily cannot be completed due to environment or dependency issues.
  • Something believed to be implemented was found, upon inspection, to actually not be implemented.

III. Situations That Do Not Require Recording

  • Random thoughts unrelated to the current task.
  • Problems that have actually been completed.
  • Speculation with no clear action value.
  • Duplicate items already recorded with no new information.

IV. Record Format

By default, use the project's existing TODO file.

If the project has no unified recording location, use TODO.md.

Format:

  • Outstanding item
    • Reason: why it needs to be handled.
    • Impact: which function it affects.
    • Related files: which files are involved.
    • Current status: why it is not completed.

For complex items, add necessary reproduction steps and verification conditions where needed.

Do not build an unnecessarily complex task management system.

V. Check Before Execution

Before starting development:

  1. Review the existing outstanding items.
  2. Check whether the current task involves any of them.
  3. Determine whether they can be completed along the way.
  4. If they affect the correctness of the current task, resolve them first.

VI. During Execution

When a new item is discovered:

  • If it can be safely completed: complete it directly.
  • If it requires additional work: record it.
  • If it is temporarily impossible: record the reason.
  • If an existing item has been resolved: update its status.
  • If an old record turns out to be inaccurate: correct the record.

VII. Check Before Delivery

Before delivery, confirm:

  1. Are there outstanding items?
  2. Are there features that are only half completed?
  3. Are there tests that were not executed?
  4. Is there documentation that is not in sync?
  5. Are there problems that were discovered but not yet handled?
  6. Have they all been recorded?

Partial completion must not be described as full completion.

VIII. Completion Status

Only work that was actually completed may be marked as completed.

A test that did not pass must not be marked as passed.

An operation that was not executed must not be marked as executed.

Functionality that was not verified must not be marked as verified.

IX. Final Principle

Not having told the user does not mean there are no outstanding items.

Unfinished work must have a record and must not disappear silently.

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.