Documentation
Préparation projet
Comment rendre n’importe quel projet prêt pour Peacae (une préparation par projet).
Project setup
Agent-ready project setup
Each codebase gets a small agent-ready setup at the repo root: agent instructions (the contract any AI tool follows), the live project board, project preferences (name, description, allowed scope), and Desktop-owned sync bookkeeping that agents ignore.
| Piece | Purpose |
|---|---|
| Agent instructions | How agents plan, update status, and stay in scope (including short titles/notes) |
| Project board | Features + nested tasks |
| Project preferences | Project name, description, allowed scope |
| Sync bookkeeping | Desktop-owned — ignore for agents |
Agents write status, not documents: prefer notes: null; when needed, one short phrase only. See Tasks, status & identity.
Git: do not commit the live board — Peacae Desktop / Cloud (or local SQLite) is the shared store. Commit the agent instructions and usually the project preferences.
Project preferences (essentials)
{
"project_name": "My Product",
"project_description": "Short description",
"scope": ["plan", "execute", "update_status", "create_tasks", "create_features"]
}Scope controls what the agent may do. If a needed scope is missing, the agent should ask — not improvise.
Add Peacae to a project
- Copy the portable agent-ready setup into the repo root
- Edit project name and scope
- In Desktop, add that project under Watched projects and enable the watcher
- Tell the agent: Follow the agent instructions
- Optional: sign in, link that watched folder to a cloud project, turn on sync
Each later session follows the working process: launch Desktop so it is watching, open your IDE in that repo, then connect with Cloud for sync if the team should see the board.
Each codebase keeps its own project setup. Desktop can watch several projects at once — add another repo the same way; do not merge two codebases onto one board.