> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobile-starter.amisi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Task Specs

> Author strict task files for planner and implementer workflows

# Task specs

Subagents work from strict task markdown files in `.ai/tasks`.

## Why strict specs

* Reduce ambiguity for impacted files and constraints
* Keep acceptance criteria testable
* Prevent out-of-scope edits

## Templates

* `.ai/tasks/templates/feature.md`
* `.ai/tasks/templates/bugfix.md`
* `.ai/tasks/templates/refactor.md`

## Required sections

* Goal
* Context
* Constraints
* Acceptance criteria
* Validation

## Example command

```sh theme={null}
bun run agent:run -- --task .ai/tasks/my-task.md --workflow hotfix
```

## Recommended constraints

* preserve public interfaces when possible
* keep adapter boundaries intact
* route env access through `@amisi/config`
* finish with `bun run verify`