26 lines
1.8 KiB
Markdown
26 lines
1.8 KiB
Markdown
# Collaboration Plans
|
|
|
|
This directory is the run queue for AI agents and maintainers coordinating work across documentation and playbooks. Treat the list below as an ordered backlog: finish the first plan before moving on to the next unless a human directs otherwise.
|
|
|
|
## Agent Execution Protocol
|
|
1. **Read the queue** from top to bottom. The numbering reflects execution priority.
|
|
2. **Open the plan file** (e.g., './plans/<slug>.md') and review the YAML front matter and the '<!-- agent-update:start:plan-... -->' wrapper so you understand the goal, required inputs, and success criteria.
|
|
3. **Gather context** by visiting the linked documentation and agent playbooks referenced in the "Agent Lineup" and "Documentation Touchpoints" tables.
|
|
4. **Execute the stages** exactly as written, capturing evidence and updating linked docs as instructed. If a stage cannot be completed, record the reason inside the plan before pausing.
|
|
5. **Close out the plan** by updating any TODOs, recording outcomes in the "Evidence & Follow-up" section, and notifying maintainers if human review is required.
|
|
6. **Return here** and pick the next plan in the queue. Always leave the README and plan files consistent with the work performed.
|
|
|
|
## Plan Queue (process in order)
|
|
1. [Base De Conhecimento](./base-de-conhecimento.md)
|
|
|
|
## How To Create Or Update Plans
|
|
- Run "ai-context plan <name>" to scaffold a new plan template.
|
|
- Run "ai-context plan <name> --fill" (optionally with "--dry-run") to have an LLM refresh the plan using the latest repository context.
|
|
- Cross-link any new documentation or agent resources you introduce so future runs stay discoverable.
|
|
|
|
## Related Resources
|
|
- [Agent Handbook](../agents/README.md)
|
|
- [Documentation Index](../docs/README.md)
|
|
- [Agent Knowledge Base](../../AGENTS.md)
|
|
- [Contributor Guidelines](../../CONTRIBUTING.md)
|