agentleFS
TokiDEVTokiDEV/team-skills/skills/team-kickoff/SKILL.md

team-kickoff

Skill3 starsChanged 8 days agoMITView on GitHub

Use when starting a brand-new project or an empty directory, and the user wants several perspectives on its vision, scope, stack and conventions before the first line of code.

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 · 1

    1. plasminds/team-skills★ 3100% same

    Edited · 0

    None found.

    Wrote their own version · 1

    1. Imtylerrrrrr/TK★ 2same 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 repository7 other files it gives its agents.

The file

We split this skill into the rules it gives an agent

6 rules. About 0 are common, 2 are distinctive, and 4 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.

  • 4

    Very specific

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

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

    REQUIRED BACKGROUND: follow team-protocol for dispatch, the run folder, the agent contract, counting positions, the bridge, structural …

    line 10
  2. Distinctive:

    Hypothesize: Write your read of the project in one sentence, plus your confidence in it (a percentage).

    line 27
  3. Very specific:

    Run team-scan on the target directory.

    line 44
  4. Very specific:

    REQUIRED SUB-SKILL: use team-view (kind: "kickoff", source = the kickoff record).

    line 93
  5. Distinctive:

    The initial structure: always on the page, as a direction choice like the ones above (or a tension), so the scaffolding workflow builds a …

    line 100
  6. Very specific:

    Delete the debate's run folder (its own handoff was skipped with its gate), then hand off (team-protocol) to the project's …

    line 111

≈ “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

team-kickoff

New-project bootstrap. Brings the roles in before there's any code, so the project's direction and conventions are shaped by the full team rather than defaulted. Reuses team-debate internally.

REQUIRED BACKGROUND: follow team-protocol for dispatch, the run folder, the agent contract, counting positions, the bridge, structural choices and the handoff.

Flow

1. Gather vision      → ask the user: what, who, why
2. team-scan          → run on the directory (even if empty — detects global tools)
3. Dispatch debate    → full debate with the vision as decision context
4. PO synthesis       → team input → kickoff record
5. Human approval     → present the kickoff record, iterate
6. Write foundations  → .council/project-profile.md + initial CLAUDE.md
7. Hand off           → existing project setup / scaffolding workflow

1. Gather vision

The roles debate the vision you bring back, so get the one the user holds, not the one that sounds right.

  1. Hypothesize. Write your read of the project in one sentence, plus your confidence in it (a percentage). Below ~70%, ask the user about what is missing first.
  2. One question at a time, each with your guess attached. The user corrects a wrong guess faster than they answer from scratch. Wait for the answer before the next question, since it often changes the next one.
  3. Listen for "should want". Buzzwords as goals ("scalable", "modern"), deferring to convention ("the standard way"), "I should probably…". Then ask: "If you didn't have to justify this to anyone, what would you build?"
  4. Stop when you can predict their answers to your next three questions. Several rounds without getting there means something basic is missing: say so and step back.
  5. Restate, in their words, one line each, and ask yes / no / refine?
    • What: what is being built
    • Who: the users and their context
    • Environment: where they use it (platform, OS, language, keyboard layout), so no role assumes its own
    • Why: the problem, and why now
    • Success: how we will know it worked
    • Constraints: the binding limits (time, money, stack, team), each one passing "what happens if we break it?" (team-protocol § Bridge)
    • Out of scope: what v1 will not do. Always filled in: half of misalignment is silent disagreement about what is not being built.
  6. Get an explicit yes. "Sounds good", "sure" and "whatever you think" are not one: ask which line they would change, or offer two concrete options. Fold corrections in and restate.

The confirmed restate is the debate's decision context, and Out of scope is its fence. Each of its Constraints enters the debate's framing as a constraint, confirmed, source "the human, kickoff restate", with a lens (business or tech; the framing and the gate JSON require one). The Wildcard may contest one; it stays binding unless the human lifts it at the gate.

2. Scan

Run team-scan on the target directory. On an empty directory it still detects globally available skills, agents, and MCP tools. The intended stack is not in the profile yet: step 6 adds it from the roles' conclusions.

3. Debate on the vision

Invoke team-debate with the confirmed restate as its framing and decision context (the user already said yes to it, so skip the debate's framing questions), with every role seated and at two-round depth: a vision is open and not cheap to reverse. The roles debate the shape of the project — scope, architecture direction, the initial structure (repo layout, packages or modules, folder conventions; team-protocol § Structural choices), UX principles, first-principles soundness, and ambitious alternatives — before anything is committed. Run the debate through its synthesis but skip its gate: step 5 is the single gate for kickoff.

4. Synthesis → kickoff record

The debate's synthesizer writes its Debate Summary (team-debate's templates.md § Synthesis): the agreed vision, the initial scope, the technical and UX direction. Points it defers past v1 go to the kickoff record's To revisit (step 5), not to tensions. A gate writer (sonnet, ~15) then sketches v1 into .council/gates/YYYY-MM-DD-kickoff/: the system view (components, data flow, external services) and, if the project has a UI, the ui view (a wireframe of the core screen). Both are after only, since nothing exists yet. Copy team-view's contract.md and figures.md into the run folder first (team-protocol); the writer draws by figures.md and builds the page by contract.md and the mapping in step 5.

5. Human approval

A record writer (sonnet, ~8) writes the kickoff record to .council/decisions/YYYY-MM-DD-kickoff.md in team-debate's Decision record shape (its templates.md § Decision record, copied in the debate's run folder), so team-plan reads it like any decision:

# Kickoff — <project>
Status: draft

## What
[The confirmed restate's line, in the user's words]

## Who
[The confirmed restate's line]

## Environment
[The confirmed restate's line: platform, OS, language, keyboard layout]

## Why
[The confirmed restate's line]

## Success
[The confirmed restate's line]

## Constraints
[In team-debate's record shape (`bridge.md`): id, lens, text, source, status; the restate's first (source "the human, kickoff restate"), then those the roles added; one the human lifted as "K<n> lifted by the human, <their words>"]

## Out of scope
[The confirmed restate's line]

## Debate Summary
[The debate's synthesis, as written]

## Accepted trade-offs
[The costs of each direction choice the human took, with who accepted them and the condition to revisit them]

## To revisit
[Points the roles defer past v1, and its dissenting views worth noting: what, who raised it, what would reopen it. A choice with no majority goes to `tensions`, not here]

## Human decisions
[Each gate item with its choice and the human's note]

REQUIRED SUB-SKILL: use team-view (kind: "kickoff", source = the kickoff record); the gate writer builds and renders the page. Map it like this:

  • summary (labelled bullets): What, Who, Why, v1 in one line.
  • settled: what the restate and the roles settled without the human.
  • Constraints: onto the cards they bind (contract.md § Bridge fields), never page level.
  • outcome: the v1 sketches from step 4.
  • Each scope item: a routine decision with options In v1 / Later / Out, and "lens": "business".
  • Each direction choice with a majority (stack, architecture, UX principles): a weighty decision whose options are the roles' alternatives, with the majority's option marked and the roles' arguments in for/against. Each option carries its tradeoff, and the item its accepts (bridge.md).
  • The initial structure: always on the page, as a direction choice like the ones above (or a tension), so the scaffolding workflow builds a layout the human chose instead of inventing one.
  • tensions: direction choices with no majority, by counting.md. To revisit stays in the kickoff record, off the page.

Iterate: notes or changed choices → the record writer revises the kickoff record, the gate writer re-renders. The human is satisfied when a decisions block comes back with nothing to revise; the record writer then sets Status: decided YYYY-MM-DD on the kickoff record.

6. Write foundations

A foundations writer (sonnet, ~10) writes both, from the kickoff record and the scan's profile:

  • .council/project-profile.md — the profile (from team-scan, enriched by the roles' conclusions about intended stack and conventions).
  • CLAUDE.md — initial project instructions: quality gates, design context, principles, conventions the roles agreed on.

7. Hand off

Delete the debate's run folder (its own handoff was skipped with its gate), then hand off (team-protocol) to the project's setup/scaffolding workflow, or to team-plan on the kickoff record if the next step is planning the first milestone.

Notes

  • team-kickoff is the only skill that expects to run before code exists; the others assume a project.
  • Everything it writes is a starting point: team-scan re-runs as the project matures.

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.