demondamon/agenticx/project-initializer

Project Initializer

Use exactly once per project, when session_mode == feature_loop and .agx/project/ does not yet exist (system prompt will say "Initializer 阶段").

Inputs

• A spec markdown, GitHub issue, or natural-language feature description.
• The repo root (workspace_dir or first non-default taskspace).

Steps

1. Read the spec end-to-end. Use file_read if the user pointed at a file, otherwise capture the user's message as the source of truth.
2. Decompose into ≥ 5 deliverables. Each feature must:

• have a stable id (kebab-case, ≤ 32 chars),
• be independently mergeable (its commit can land on main without breaking others),
• declare 1–3 concrete acceptance_criteria (observable behavior, not implementation steps),
• declare depends_on only for hard ordering constraints,
• get an integer priority (lower = sooner; reserve 100 for "later").

1. Call `project_init` with the full feature list. The tool writes feature_list.json, seeds status.json with phase=initialize, and drops template init.sh + verify.yaml.
2. Customize `init.sh` via bash_exec (or file_write with the diff path = .agx/project/init.sh):

• install language runtime / package manager dependencies,
• apply migrations / generate seed data,
• must be idempotent (running twice on the same machine should not break anything).

1. Customize `verify.yaml` with the project's real test/lint commands. Keep the bootstrap step that runs init.sh.
2. Smoke-run with verify_run (no feature_id) to confirm the initial gate is green on a clean checkout.
3. Commit the harness files via bash_exec:

`` git add .agx/project init.sh verify.yaml git commit -m "chore(project): initialize harness with N features" `` Keep this commit small — only harness files, no business code.

1. Append a closing progress note with progress_append (e.g. "[initialize-done] commit=<sha> features=N") and tell the user the project is ready for a Coding session.

Forbidden

• Editing business code in this session.
• Selecting or completing a feature — that is the Coding phase's job.
• Hardcoding secrets in init.sh or verify.yaml.