Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

project-builder

Project Lifecycle Agent plugin for Claude Code. Extends the idea of a one-shot "Workflow Builder" into a persistent Project Operating System: discovery, requirements, architecture, workflow, task planning, and review, all tracked in a .project/ state directory so work can be resumed, reviewed, and changed without re-planning from scratch.

Install

Claude Code:

/plugin marketplace add /path/to/project-builder
/plugin install project-builder

Codex: the skill is also exposed via .codex-plugin/plugin.json (skills: ./skills/). The /project slash command is Claude Code-only — Codex users invoke the skill through natural language.

Use

Natural language ("프로젝트 시작하자", "다음 뭐 해야 돼?", "이 기능 추가하자", "프로젝트 점검해줘") or the /project command (Claude Code only):

/project status         # 현재 상태 요약
/project next            # 다음에 할 작업 추천 + 이유 + 대안
/project plan             # discovery → requirements → architecture → workflow → tasks
/project review           # coverage / drift / validation 점검
/project requirements     # requirements.md 조회·갱신
/project architecture     # architecture.md 조회·갱신
/project tasks             # 전체 task 상태 요약

How it works

Everything lives under .project/ in the target repository:

.project/
├── PROJECT.md       # stable facts
├── STATE.md         # current status — read every session
├── requirements.md  # REQ-xxx
├── architecture.md  # system structure + DEC-xxx
├── workflow.md        # phases + exit criteria
└── tasks/
    ├── backlog/ active/ done/   # TASK-xxx.md with YAML frontmatter

skills/project-builder/scripts/tasks.py computes the task graph deterministically instead of asking the model to eyeball frontmatter: it parses only YAML-lite frontmatter (never task bodies), and returns which tasks are ready (already sorted by blocking power → priority → phase — the ready list is the parallel-safe set, since a READY task's deps are all done), which are blocked and why, and structural issues (cycles, missing deps, duplicate ids, status/folder mismatches). No third-party dependencies; python3 tasks.py --selftest runs its own fixture-based checks. See skills/project-builder/references/ for the full protocol.

v1 scope

project-orchestrator + project-discovery + requirements-builder + architecture-builder + workflow-builder + task-builder + project-reviewer + change-manager, unified as capabilities of a single skill (skills/project-builder/) rather than eight competing skills.

Not yet implemented (v2/v3 candidates): project-research, implementation-guide, test-planner, release-manager, documentation-manager, decision-manager (standalone), risk-manager, drift-detector (standalone), project-health.

Repository hygiene not yet done

No LICENSE file, no CI, no SKILL.md spec validator committed (checked manually against auto-dev's scripts/validate.py at build time — passes).

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages