This section is generated by small init or small agents apply.
Do not edit manually unless you know what you are doing.
Files in .small/ have explicit ownership:
| File | Owner | Description |
|---|---|---|
| intent.small.yml | human | Project intent and success criteria |
| constraints.small.yml | human | Hard constraints agents must follow |
| plan.small.yml | agent | Task breakdown and execution plan |
| progress.small.yml | agent | Append-only work log |
| handoff.small.yml | agent | Resume context for next agent |
| workspace.small.yml | agent | Workspace metadata |
Human-owned files: Agents MUST NOT modify without explicit human approval. Agent-owned files: Agents may modify freely within protocol rules.
- progress.small.yml is append-only
- plan.small.yml is replaceable
- handoff.small.yml is the only resume entrypoint
small check --strict enforces additional invariants:
- S1: Completed/blocked tasks must have progress entries with evidence
- S2: All progress task_ids must reference valid plan tasks (or use meta/ prefix)
- S3: Handoff current_task_id must exist in plan
- S4: No unknown files or subdirectories under .small/
Insecure http:// links are blocked EXCEPT in progress.small.yml where these are allowed:
- http://localhost
- http://127.0.0.1
- http://0.0.0.0
- http://[::1]
When blocked or unable to proceed, agents MUST:
- Record in progress: Add an entry explaining the blocker
- Update handoff: Set resume.current_task_id and document the issue in next_steps
- Stop: Do not attempt workarounds or unauthorized actions
This ensures human operators can review and unblock safely.