Context Hygiene
Keep always-loaded and per-session files within their word-count budgets. Flag overages and compact when needed.
Budgets
| Category | Description | Narrow scope | Inlines skills | Includes env snippet | Agents | Word Budget |
|---|---|---|---|---|---|---|
| Chat | General-purpose, full context | No | No | Yes | Forge Chat | ≤ 1,500 |
| Runner | Dispatches other agents | No | No | Yes | Project Runner, Task Runner | ≤ 700 |
| Worker | Executes project skills | Yes | Yes | Yes | Project Worker | ≤ 300 |
| Thinker | Plans, designs, reasons | Yes | Yes | Yes | Project Thinker | ≤ 300 |
| Evaluator | Reviews against intent | Yes | Yes | Yes | Project Evaluator | ≤ 300 |
| Handler | Executes one narrow domain | Very | Yes (1–2) | Yes | Page Manager | ≤ 300 |
Skill SKILL.md budget: ≤ 500 words.
Budget applies to the agent’s own prompt content including inlined shared snippets, but excluding inlined skills.
Compaction Procedures
Skill SKILL.md compaction
When a skill SKILL.md exceeds 500 words:
- Review the procedure and rules
- Move deep reference material into
references/files - Keep SKILL.md as procedure outline + pointer (≤ 500 words)
- Preserve YAML frontmatter