Run a backlog task

A backlog item becomes executable only after the developer selects it and the agent converts it into a Task Contract grounded in the current repository.

Select one item

Identify the item precisely by ID or pass its source:

tcaf task --target <project> --request "Run backlog item B-016"

tcaf task --target <project> --input <backlog-item-file>

Do not combine neighbouring items merely because they touch the same area.

Reconcile source and repository

Before writing the contract, verify:

• current status and acceptance criteria;
• relevant dependencies;
• whether the repository already contains part of the requested work;
• whether the item is still valid as written;
• which files and behaviours must be preserved;
• whether comments or decisions changed the original scope.

If source and repository disagree materially, stop and request a decision.

Contract and implementation

The contract should retain the backlog item identity and define only the authorized implementation surface. Historical wording remains in the backlog; the contract explains how the selected work applies to the current codebase.

Implement preservation-first, run targeted checks and report the result without changing backlog status automatically.

Complete the backlog item

After the developer accepts the implementation:

1. reconcile the backlog in a separate authorized step;
2. preserve unfinished criteria as open work;
3. record evidence or commit references where appropriate;
4. commit and push only under separate authorization.