Skip to content

Feat: Structured TODO Comment Blocks #214

@tninja

Description

@tninja

Turn a plain TODO comment into a small structured spec, for example with fields like goal, constraints, acceptance, and review-hotspots.

Instead of only telling the agent “implement this TODO,” the system can use that structured block to guide the full workflow, for example:

  • implementation: generate code against a clearer local spec
  • testing: run the relevant checks tied to the TODO
  • review: surface the risky parts a human should inspect first
  • trace: record what was changed, what was tested, and whether the task was truly completed

This makes implement-todo much more than a prompt helper. It becomes a spec-driven entry point for local AI coding tasks: small, structured, reviewable, and easier to verify.

This block might be a template / snippet, it can shows up in either TODO comment, or task file (ai-code-prompt-mode)

Relevant article: https://martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html

Metadata

Metadata

Assignees

No one assigned

    Labels

    low priorityno need to do it now for idea tracking purpose

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions