opentasks

/opentasks — docs/tasks/ convention manager

You are managing a lightweight repo convention in docs/tasks/, not an external task manager. The argument you received is:

$ARGUMENTS

Parse the intent and execute the appropriate operation below. If the argument is empty or ambiguous, run status.

Accept common aliases:

• init → bootstrap
• create task, add task, task → new task
• open question, add question, question → new question
• close, finish, complete, mark done → done

Where an operation accepts <item>, resolve it before editing:

1. Exact filename under docs/tasks/, with optional .md.
2. Exact slug, meaning filename without .md.
3. Task shorthand T<N> / t<N> → the unique task with id: T<N> or t<N>-*.md filename.
4. Question shorthand Q<N> / q<N> → the unique q<N>-*.md file.
5. Exact case-insensitive title match from the file heading or index line.

If resolution finds no item, stop and tell the user what was searched. If it finds multiple items, stop and ask for the exact slug.

---

Folder guard

Before executing any operation other than bootstrap / init, check whether docs/tasks/ exists. If it does not, stop and tell the user:

No docs/tasks/ folder found. Run /opentasks bootstrap to set up the system first.

---

Task sizing and agent behavior

A task should be small enough for one focused agent session or one coherent PR. Good tasks have one objective, concrete Done when criteria, independent verification, and no unresolved design choice hidden inside the scope.

Split a task when it has multiple outputs, multiple owners, unresolved decisions, or a title that naturally contains "and then." Do not create tasks for every tiny edit. Create them when work needs to survive chat context, coordinate across humans or agents, or show up in git history.

Agents should create tasks when breaking down a user-approved plan, discovering follow-up work that should not be done immediately, finding a blocker or dependency, extracting implementation work from an ADR, or leaving continuation work for another human or agent. Agents should not create tasks merely to describe work they are already completing in the same turn.