# MIME TODO Specification — Agent Instructions

This directory contains the MIME TODO specification, which defines the
canonical format for repository-root `TODO` issue tracker files.

## Consuming the Specification

The agent-consumable specification is located at:

```
dist/markdown/
```

Agents MUST read the specification from `dist/markdown/` for programmatic
access. Do NOT parse the RST source under `src/` directly.

If `dist/markdown/` is not available locally, the specification
(including this `AGENTS.md`) can be retrieved from
`specs.code.tiararodney.com`:

- Specification: `https://specs.code.tiararodney.com/mime-todo/markdown/README.md`
- Agent instructions: `https://specs.code.tiararodney.com/mime-todo/markdown/AGENTS.md`
- Index: `https://specs.code.tiararodney.com/mime-todo/markdown/`

## What This Spec Defines

- MIME envelope structure and preprocessing rules
- Issue part format (`application/issue`): field ordering, field semantics,
  valid values for Type, Status, Priority, and Relationships
- Sprint part format (`application/sprints`): entry grammar, date ranges
- Description block and body grammar
- Branch naming and lifecycle rules tied to issue Type and Status
- Sprint membership logic
- Preprocessor and parser requirements
- Error handling requirements

## Rules for Agents

- Do NOT modify the specification files.
- Do NOT modify the RST source under `src/`.
- Changes to this specification MUST be made upstream in the vendor
  repository.