KeiSeiKit-1.0/skills/onboard/phase-5-report.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

3.1 KiB

Phase 5 — Final Report

Concise summary + suggested next steps. No AskUserQuestion calls — this phase is pure output.

5a — Summary block

Emit in this exact shape:

=== ONBOARD REPORT ===
Scope:       <N project(s): path1, path2, ...>
Granularity: <per-project | bulk-same-config | mixed | n/a>
Mode:        <full-auto | step-by-step | full-manual>

Scan signals:
  Stack:     <per-project stack list>
  CI:        <per-project CI list>
  Deploy:    <per-project deploy hints>
  Tests:     <per-project test presence>
  Env vars:  <names only, per project>

Candidates:
  Proposed:  <N agents | M hooks | K primitives>
  Applied:   <N agents | M hooks | K primitives>
  Skipped:   <count with reasons>

AskUserQuestion count (this skill run):
  Phase 1:   <0 | 1>    (scope granularity if multi-project)
  Phase 3:   <1 | N>    (mode pick, possibly per-project)
  Phase 4:   <varies by mode>
  Total:     <sum>

5b — Suggested next steps

Compose 3-6 one-line bullets conditional on the scan + applied outcome:

  • If any agent was applied:

    • Create project memory: touch ~/.claude/memory/<slug>-project.md
    • Add one line to MEMORY.md: [[<slug>-project]] — <description>
    
  • If hooks were applied:

    • Reload Claude Code settings to activate new hooks (restart session)
    
  • If primitives were queued via kei-sleep-queue:

    • Next sleep session will install queued primitives — run /sleep-on-it
      when ready
    
  • If primitives were suggested for immediate install:

    • cd <kit-repo> && ./install.sh --add=<p1>,<p2>,<p3>
    
  • If DB artefacts detected but no kei-migrate installed:

    • Run install.sh --profile=dev to enable /schema-design and /db-migrate
      skills (DB workflow detected in <project>)
    
  • If frontend detected but no frontend primitives installed:

    • Run install.sh --profile=frontend for live-preview, design-scrape,
      screenshot-decode, frontend-inspect
    
  • If banned-public deploy detected (ML weights / offensive tools):

    • Review security-restricted-projects.md — confirm this project's
      deploy-local-only status is documented before any infra handoff
    

5c — Failure surfacing

If any candidate in SKIPPED has a failure reason (not user-declined), append a "Failures" block:

Failures (constructive paths offered):
  - <candidate-name>: <failure reason>
    (A) Retry via /new-agent manually
    (B) Edit the scan-derived suggestion and re-submit
    (C) Abandon this candidate

Never close a skill run with a silent failure — RULE -1 (NO DOWNGRADE) forbids it. Every failure gets 2-3 constructive paths in the final report.

Verify-criterion

  • Report covers every project in PATHS.
  • Applied + Skipped totals match Proposed totals for each kind (agents, hooks, primitives).
  • AskUserQuestion count is ≥6 across the full skill run (Phase 1 optional 1 + Phase 3 at least 1 + Phase 4 at least 4 combined across modes, or downstream wizard AskUser calls counted for full-manual).
  • No fabricated paths — every APPLIED entry cites a real manifest/hook/ queue-UUID on disk.