agentleFS
zdnemzzdnemz/claude-team/.claude/skills/initialize-project/SKILL.md

initialize-project

Skill1 starsChanged 4 months agoMITView on GitHub

Initialize the autonomous agent system from docs/proposal.md — interview the user, generate specs and legend→epic→story→task plans, assemble the project-specific team, set state to PLANNED. Use when state phase is UNINITIALIZED (or resuming INITIALIZING) and docs/proposal.md exists.

2 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions2 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 2

    1. yu-iskw/skill-inspector★ 2same name
    2. yu-iskw/coding-agent-fabric★ 1same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository5 other files it gives its agents.

The file

We split this skill into the rules it gives an agent

4 rules. About 0 are common, 2 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Run the phases IN ORDER. Persist after every phase (memory MCP) so a crashed or compacted session resumes cleanly — on resume, …

    line 8
  2. Very specific:

    Read docs/proposal.md fully.

    line 13
  3. Distinctive:

    Only if neither is available: run your own interview — ONE question at a time via AskUserQuestion, concrete options, stop when new answers …

    line 20
  4. Distinctive:

    No git repo yet → ask the user once, then git init + initial commit ("agent system + specs + plans").

    line 49

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Initialize Project

Run the phases IN ORDER. Persist after every phase (memory MCP) so a crashed or compacted session resumes cleanly — on resume, progress_status tells you which phase you were in; skip completed ones.

First: state_set {phase: "INITIALIZING"}.

Phase 1 — Ingest

  1. Read docs/proposal.md fully. Read every readable file in docs/additional/ (note skipped binaries).
  2. memory_save context/proposal-digest: goals, users, constraints, stack hints, explicit unknowns.
  3. progress_log {status:"done", note:"init phase 1: ingest"}.

Phase 2 — Interview (mandatory, never skip)

Goal: ~95% confidence about what the user actually wants, not what the proposal literally says.

  • Invoke the interview-me skill (vendored in .claude/skills/interview-me/; falls back to agent-skills:interview-me if the plugin form is what your harness lists). Drive it to ~95% confidence.
  • Only if neither is available: run your own interview — ONE question at a time via AskUserQuestion, concrete options, stop when new answers stop changing the plan.

Cover whatever the proposal leaves open (skip what it already answers): target users + the core job-to-be-done · v1 scope cut (what is explicitly OUT) · platform + stack constraints · quality bar (throwaway prototype vs production) · security/compliance/PII needs · deploy target + who operates it · the ONE success metric · deadline/budget.

memory_save context/interview-answers (verbatim Q→A) · progress_log phase done.

Phase 3 — Specs

Spawn architect (opus) with the proposal digest + interview answers. Deliverables in docs/specs/:

  • 01-product.md — users, jobs, scope in/out, success metrics
  • 02-architecture.md — components, data flow, stack choice + rationale, ADRs
  • 03-data.md — entities, schema sketch (when the project has data)
  • 04-security.md — spawn security-engineer (opus) to threat-model 02 and write this
  • 05-operations.md — environments, CI/CD, observability, release (when deployable)

Skip files genuinely irrelevant to the domain; record each skip + reason in the legend later. Review the specs yourself against the interview answers, then present a summary to the user and get approval BEFORE planning. memory_save decisions/spec-approval · progress_log.

Phase 4 — Plans

Spawn planner (opus) with the approved specs. It writes docs/plans/legend.md + docs/plans/epics/EP-*.md per .claude/system/templates/plan-format.md. Then verify the quality bar yourself (every task has role/model/verify/deps; stories have testable criteria; DAG has no cycles). Not met → respawn planner with specific feedback. Present plan stats (epics/stories/tasks, sequence) to the user for approval. progress_log.

Phase 5 — Team & tooling (the whole toolchain is mutable here)

Via skill manage-agents, reshape the system to fit THIS project:

  1. Agents — create missing domain roles (ml-engineer, mobile-engineer, firmware-engineer, game-engineer, data-engineer, …); modify shipped agents whose specialty guidance or model tier doesn't fit the domain; remove roles the project will never use (e.g. frontend-engineer for a pure CLI). Registry updated either way.
  2. Skills / hooks / MCP servers — add or remove as the plan requires (e.g. a domain-specific procedure skill, a lint hook, an API MCP). Only what a concrete plan task needs — no speculative tooling.
  3. Knowledge graph — run /graphify docs/ so proposal, specs, and plans are queryable during execution.
  4. memory_save context/team-roster (roster + what was added/modified/removed and why) · progress_log.

Phase 6 — Commit

  1. No git repo yet → ask the user once, then git init + initial commit ("agent system + specs + plans").
  2. state_set {phase:"PLANNED", detail:"<first epic id>"} · progress_log {status:"done", note:"initialization complete"}.
  3. Report: specs written, plan stats, team roster, and: type start to begin execution. Do NOT start executing without the user saying so.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.