Menu
Git conventions for the factory workspace and project repos.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Complete reference for the factory CLI — all commands, arguments, options, and usage. Use when an agent needs to invoke factory commands, check correct syntax, or understand available options.
When and how to write a human-action-needed entry to memory/{agent}/needs.md. Agents write these entries when they hit blockers that only a human can resolve.
When you encounter a failure, correction, or new pattern, write a learning and optionally propose a skill.
How the factory workspace is organized and what each directory means.
What to examine during a reflection pass and how to write observations to memory/{agent}/needs.md.
When and how to write scenario holdouts for factory verification.
| name | git-workflow |
| description | Git conventions for the factory workspace and project repos. |
The entire factory workspace is a git repo. Commit conventions:
task: move {task} from {src} to {dst} — for task state transitionsskill: propose {skill-name} — for new skill proposalsskill: promote {skill-name} — when Librarian approves a skillmemory: update {file} — for memory writeslearning: {type} - {summary} — for new learningsCommit after every meaningful state change. Small, frequent commits.
Each project is its own git repo within projects/. Conventions:
main branch is always deployable{agent}/{brief-description}runs/)