Files of the hub
The hub holds what the factory knows about the product. Run the agents in it. The code is in the repositories that it names.
| Path | It holds | It changes |
|---|---|---|
context/ | Positioning, glossary, rules, decisions, non-goals | Rarely. Only accept or you change it. |
inbox.md | Work that is not a task yet: ideas, deferred work, discovered work | Often |
tasks/ | One file for each change task | Each task stays, with its last status |
explorations/ | One folder for each exploration: exploration.md and its artifacts | Each exploration stays, with its last status |
The hub also has these files.
- acme-hub/
- CLAUDE.mdThe rules of each session
- factory.jsonRepositories, setup commands, modes
- mars.yamlThe repositories of this hub
- scripts/
- factory-session.shStarts a session for the panel
- setup.mjsSets up the hub on a computer
- sync-issues.mjsMirrors tasks to GitHub issues
- update-skills.mjsUpdates the skills
- .claude/
- settings.jsonPermissions
- state-machine.md
- skills/
- repos/Clones of the code repositories, not in git
- .factory/builds/A folder for each build, not in git
#Rules for each session
CLAUDE.md gives the rules that each session follows.
- Use the words of
context/glossary.md. Do not use a different word for the same thing. - A task gives the number of a decision. Do not copy the text of a decision into a task.
- Keep a fact in its task or exploration. When a future task will get it wrong without the fact, write it under
## Context changes.
#Set up the hub on another computer
Clone the hub, and run the setup script. It checks the tools, clones the repositories into repos/, and runs the setup command of each one. It changes only what is missing, so you can run it again.
node scripts/setup.mjs --no-paseo