Factory
Pages

Files

#The hub

  • acme-hub/
    • CLAUDE.mdThe rules of each session
    • factory.jsonRepositories, setup commands, permission mode
    • mars.yamlThe repositories of this hub
    • inbox.mdWork that is not a task yet
    • context/
      • positioning.md
      • non-goals.md
      • glossary.md
      • decisions/
      • rules/
    • tasks/One file for each change task
    • explorations/One folder for each exploration
    • scripts/
      • factory-session.shStarts a session
      • update-skills.mjsUpdates the factory skills
    • .claude/
      • settings.jsonPermissions and plugins
      • state-machine.mdThe only place for the statuses
      • skills/
    • repos/Checkouts of the apps, not in git
    • .factory/builds/A folder for each build, not in git

#factory.json

FieldIt gives
repos.<name>.setupThe command that prepares a checkout for a build
build.modes.claudeThe permission mode of each session
aws.regionThe region that the Review button uses
githubMore repositories for the panel to read, as owner/name
skills.commitThe commit of factories-hub that the factory skills come from

#The app

  • acme/
    • CLAUDE.mdSetup, checks, required skills
    • buildspec.ymlWhat CI runs
    • flow.lockThe Flow choices
    • vendor/The Flow tarball
    • .flow/
      • review.ymlThe review settings
      • docs/Not in git
      • lenses/Not in git
    • .claude/
      • settings.jsonEnables modern-web-guidance
      • skills/flow-* are not in git. The others are.
      • skills-licenses/

#factory-kit

  • factory-kit/
    • bin/new-project, connect-repo, review-pr
    • hub/The template of a hub
    • app/What new-project adds to an app
    • aws/The CodeBuild templates and config.env
    • herdr/factory/The panel
    • skills/Skills of other authors, at pinned commits
    • vendor/The Flow tarball. The newest file wins.