T is a small bash helper for moving around the task system: list active tasks, open details, edit, show state, archive, work the backlog. It is a convenience wrapper — the canonical workflow lives in agent-task-rules.md.

What it is

A shell script at scripts/T that wraps common task operations against tasks/index.md and tasks/details/<id>.md. Run T with no arguments or T h for the current command list; the script’s own help is the source of truth for available commands.

When to use it

• You want to jump to a task’s details without typing the full path.
• You are listing or filtering active tasks from the terminal.
• You are working the backlog or archiving and prefer the helper to the raw file moves.

When to skip it

• You are editing the files anyway. T does not do anything you cannot do by hand.
• You need behavior the script does not cover — go to the rules doc and the underlying files.

How to invoke

scripts/T            # show help
scripts/T l          # list active tasks
scripts/T d <id>     # show task details
scripts/T e <id>     # open task in editor

Single source of state

Task state lives in tasks/index.md markers — [ ] pending, [i] in-progress, [x] done. Detail files hold context (Next, Blocked, Outcome, Done-when), not state. If T output and tasks/index.md ever disagree, trust index.md.

Self-review

Before declaring a task done, re-read the spec and audit every file you touched: spec compliance, API contract, security, test coverage. Skip this and you will ship half-finished work. The full checklist lives in agent-task-rules.md under “Self-Review”.

Reference

• Script: scripts/T
• Rules (state, self-review, lifecycle): agent-task-rules.md