{
 "schema_version": 1,
 "generated": "2026-10-20",
 "id": "addyosmani-factory--install-factory-into-existing-repo",
 "repo": "addyosmani/factory",
 "repo_url": "https://github.com/addyosmani/factory",
 "repo_slug": "addyosmani-factory",
 "title": "Install the Factory into an existing GitHub project",
 "page_title": "How to install the Factory into an existing GitHub project with Factory",
 "summary": "Add the committed Claude and Codex Factory files to a repo and check the setup with doctor.",
 "who": "A developer who wants to automate issue work in an existing GitHub project and needs the Factory files installed first.",
 "problem": "Setting up agent-driven delivery by hand means guessing which policy, skill, label, and gate files a repo needs, and missing one can leave runs silently unsafe.",
 "outcome": "The target repo contains the Factory policy, skills, and gates, and the doctor script reports placeholders, missing labels, and remote gaps to fix before any run writes to the repo.",
 "steps": [
  "Clone the addyosmani/factory repository to your machine.",
  "Run `install.sh` against the target repository you want to automate.",
  "Open the target repository in your coding agent and fill in `docs/factory/CHARTER.md`.",
  "Run `.factory/scripts/doctor.sh` and fix every placeholder, missing label, or missing remote it reports.",
  "Open `/factory` to confirm the control room shows the expected state before enabling writes."
 ],
 "agent_prompt": "Using the addyosmani/factory repository, install the factory into <target-repo-path> by running install.sh against it. Then run .factory/scripts/doctor.sh inside the target and report every finding. Expected output: a list of remaining setup gaps, or confirmation that none remain. Verify that docs/factory/CHARTER.md exists in the target.",
 "agents": [
  "claude-code",
  "codex"
 ],
 "difficulty": "Intermediate",
 "time": "1 hour",
 "basis": "readme",
 "caveat": "The README says the Factory is an installer for another project and that the Claude unattended schedules and cloud routines are set up separately, so a successful install does not mean scheduled runs are active.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "shell",
 "requirements": [
  "A GitHub project you control, with permission to create labels and manage its pull requests",
  "Claude Code installed, or Codex if you use the Codex adapter",
  "A clone of the addyosmani/factory repository",
  "Your project's real test, lint, and build commands, since the gates run them",
  "A human-owned docs/factory/CHARTER.md that defines scope, risk, and the review-queue limit"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": true,
 "score": 1.0,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/addyosmani-factory/install-factory-into-existing-repo/",
 "md": "https://dedupedai.com/use-cases/addyosmani-factory/install-factory-into-existing-repo/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/addyosmani-factory--install-factory-into-existing-repo.json",
 "api_version": "v1"
}