KeiSeiKit-1.0/skills/new-project/phase-1-intake.md
Parfii-bot 0be354a920 KeiSeiKit-public — clean state
Single-commit clean baseline after security scrub of niche-tells,
project codenames, internal jargon, and contributor-email leaks.

Contents:
- 100 Rust crates (_primitives/_rust/)
- 37 agent manifests (_manifests/) + generated specs (_generated/)
- 67 user-invocable skills (skills/)
- 33 hooks (hooks/)
- Composition blocks (_blocks/)
- Documentation (docs/, README.md)
- TS adapter packages (_ts_packages/)
- Assembler (_assembler/)
- Roles (_roles/)
- Templates (_templates/)
- Forgejo CI (.forgejo/)

Author: Denis Parfionovich <info@greendragon.info>

License: see LICENSE.
2026-05-01 12:09:03 +08:00

92 lines
4 KiB
Markdown

# Phase 1 — Intake
One free-text line + one click batch of 5 questions. Only Phase 1a is typed.
## 1a — Ask for the project goal
Emit a regular message (NOT AskUserQuestion):
> Describe the project in one line: what do you want to produce / prove /
> ship, at what scope (feature / service / paper / proof)? Reply in one
> message. The main agent and sub-agents will read this verbatim.
Store the reply as `GOAL`. Derive `PROJECT_SLUG = kebab-case(first 4-6
meaningful words of GOAL)`, ≤ 40 chars, ASCII only.
## 1b — Shape click (AskUserQuestion, ONE batch of 5)
```json
{
"questions": [
{
"question": "Project type?",
"header": "Type",
"multiSelect": false,
"options": [
{"label": "new code", "description": "Greenfield implementation — ship a running artefact"},
{"label": "research", "description": "Empirical investigation — experiments + results doc"},
{"label": "theoretical", "description": "Math / physics / algorithmic derivation — proofs + chatlog"},
{"label": "hybrid", "description": "Code + theory in parallel — both tracks merged at end"},
{"label": "documentation", "description": "Docs-only project — no new runtime code"}
]
},
{
"question": "Theoretical component shape?",
"header": "Theory",
"multiSelect": false,
"options": [
{"label": "none", "description": "Pure-implementation project"},
{"label": "math derivation", "description": "Lemma → theorem chain, reviewed by physics-deriver"},
{"label": "prior-art research", "description": "Literature + existing-project sweep before any write"},
{"label": "architecture spec", "description": "Design document + interface contracts before code"},
{"label": "paradigm analysis", "description": "Observable classification + falsifier design"}
]
},
{
"question": "Parallel sub-agent budget?",
"header": "Fanout",
"multiSelect": false,
"options": [
{"label": "single", "description": "Main agent only — sequential work, no sub-forks"},
{"label": "up to 3", "description": "Small fleet — typical feature work"},
{"label": "up to 5", "description": "Medium fleet — multi-track research or cross-cutting refactor"},
{"label": "up to 10", "description": "Wide fanout — parallel experiments / audits / prior-art sweeps"}
]
},
{
"question": "Main-agent role?",
"header": "Main",
"multiSelect": false,
"options": [
{"label": "meta-orchestrator", "description": "Generic orchestrator that only fans out and merges"},
{"label": "spawn specialist", "description": "Create a new dedicated agent via /new-agent before Phase 2"},
{"label": "compose-solution decides", "description": "Hand off project shape to /compose-solution for auto-routing"}
]
},
{
"question": "DB / ledger mirror?",
"header": "DB",
"multiSelect": false,
"options": [
{"label": "file-only", "description": "No SQLite — write bundle files only; skip kei-ledger"},
{"label": "SQLite ledger", "description": "Use kei-ledger (default — RULE 0.12 compliant)"},
{"label": "external tool", "description": "Mirror to another tracker (Jira / Linear / Forgejo issues)"}
]
}
]
}
```
Store answers as `PROJECT_TYPE`, `THEORY_PART`, `FANOUT`, `MAIN_AGENT`,
`DB_MODE`.
## Verify-criterion
- `GOAL` non-empty.
- `PROJECT_SLUG` matches `^[a-z0-9][a-z0-9-]{2,39}$`.
- All 5 click answers are exactly one of the labels above.
- If `MAIN_AGENT == "spawn specialist"` — Phase 2 begins with a handoff to
`/new-agent` before any ledger fork.
- If `DB_MODE == "file-only"` — Phase 2 skips the `kei-ledger fork` call
but STILL writes the 6-file bundle. Report this deviation in the final
report so the user sees the ledger SSoT was bypassed by explicit choice.