← Back to archive

Repo of the Day

Druthulu/ProjectArchitect

Published: Nov 16, 2026

Open repository ↗

Claude Code workflow and idea-roadmap-complete project workflow

Summary

Project Architect (PA3) is a Claude Code workflow for taking an idea through roadmap planning and project execution. It stores plans, milestones, task summaries, decisions, rules, and techniques as repository files, then runs approved tasks in separate contexts so work can continue across sessions without relying on one long transcript.

What it is useful for

PA3 is useful when an engineer wants Claude Code to manage a multi-phase project rather than answer isolated coding questions. Each phase has a milestone that can be checked by a machine, and the engineer approves the plan before implementation begins. Near the end, Claude asks for confirmation before closing the phase and leaves a plain-English recap.

The workflow is also designed around context size. Retrievers read large files and return focused answers; coders handle edit, build, and test loops; and an expert handles each task in a fresh context. Repository files preserve useful project state between sessions, while a local ledger and statusline report request costs and the context kept out of the main session. For example, an engineer can keep architectural decisions and task results in the repository, delegate approved tasks to separate workers, and retain human approval at the two main project gates.

Optional external coding can use DeepSeek or GLM through OpenRouter with the engineer’s own key, while planning and judgment remain with Claude.

How engineers can use it

The documented prerequisites are Claude Code 2.1.292 or newer, a Claude Ultra, Max, or Pro subscription, Python 3.12 or newer, and Git.

  1. Once per machine, download the repository as a ZIP, extract it, open project-architect-3.0, and run install.cmd on Windows or ./install.sh on WSL, Linux, or macOS. The installer also installs the mod and the Claude Code plugin.
  2. Once per target repository, open it in Claude Code and type the setup command PA3 displays, then restart with /exit and claude. On Windows, setup-project.cmd provides a folder picker instead. This setup creates one commit and does not push it.
  3. Start a bare claude session in the repository. Describe the goal or ask Claude to assess the project’s status; PA3 will organize the next phase around a checkable milestone.

On the first session, PA3 points to Claude’s billing settings and provides a command for recording the plan renewal date.

Engineers should expect two approval points: one after planning and one before phase closure. The README also documents that PA3 stays serial and links to design notes explaining that choice. Optional OpenRouter use adds its own key requirement.