@firatcand/roster 0.1.0

package/templates/scaffold/chief-of-staff/plans/audit-project.yaml

@@ -0,0 +1,34 @@
+plan: audit-project
+description: |
+  Validate a project's completeness. Reports issues with suggested fixes;
+  never auto-fixes. Checks required guideline files (non-template content),
+  optional files (presence only), root files, agent instances, and
+  instance↔CLAUDE.md consistency.
+
+inputs:
+  project:
+    required: true
+    description: Project slug (must exist at projects/<slug>/).
+
+outputs:
+  status: string  # pass | warn | fail
+  report_path: string
+
+steps:
+  - id: execute
+    tool: bash
+    args:
+      command: bash scripts/audit-project.sh ${inputs.project}
+    description: Run the backing audit script.
+
+  - id: report
+    description: |
+      Print the condensed summary to stdout. Reference the full report at
+      chief-of-staff/logs/<YYYY-MM>/audit-${inputs.project}-<YYYY-MM-DD-HHMM>.md.
+      Severity rules:
+        - Failure: required file missing/template, instance config invalid YAML,
+          instance project field mismatches folder name.
+        - Warning: optional file missing, instance not listed in CLAUDE.md,
+          last run > 30 days old.
+
+approval_channel: session

package/templates/scaffold/chief-of-staff/plans/audit-repo.yaml

@@ -0,0 +1,26 @@
+plan: audit-repo
+description: |
+  Full-repo audit. Runs project audits for every live project and agent
+  audits for every live agent. Aggregates into one report. Also checks
+  universal .mcp.json, universal .claude/settings.json, root CLAUDE.md /
+  conventions.md / README.md, and orphaned instances.
+
+inputs: {}
+
+outputs:
+  status: string  # pass | warn | fail
+  report_path: string
+
+steps:
+  - id: execute
+    tool: bash
+    args:
+      command: bash scripts/audit-repo.sh
+    description: Run the backing aggregator script.
+
+  - id: report
+    description: |
+      Print top-level summary. Reference the full report at
+      chief-of-staff/logs/<YYYY-MM>/audit-repo-<YYYY-MM-DD-HHMM>.md.
+
+approval_channel: session

package/templates/scaffold/chief-of-staff/plans/create-agent.yaml

@@ -0,0 +1,123 @@
+plan: create-agent
+description: |
+  Create a new global agent under a registered function. Runs in one of two
+  modes:
+
+  - **stub** — byte-identical to `bash scripts/new-agent.sh`. Drops empty
+    placeholder files (purpose `<one paragraph...>`, plan stubs, etc.) and
+    exits. Headless / CI / legacy escape hatch.
+  - **guided** — runs the Guided Agent Creation dialogue defined in
+    `skills/chief-of-staff/SKILL.md` § "Guided Agent Creation" (see P4-T02).
+    Produces the same on-disk layout as stub mode, but with agent.md
+    sections filled in from the dialogue answers.
+
+  Either mode optionally instances the resulting agent into existing
+  projects (or prompts the caller to pick).
+
+inputs:
+  function:
+    required: true
+    description: Function slug (must be registered in `.config/functions.yaml`).
+  agent:
+    required: true
+    description: Agent slug (lowercase, kebab-case, starts with letter).
+  mode:
+    required: false
+    description: |
+      Explicit branch override: `stub` or `guided`. If omitted, `resolve_mode`
+      picks based on env + TTY (see that step).
+  add-to-projects:
+    required: false
+    description: List of project slugs to instance into. If omitted, the cross-link prompt runs.
+
+outputs:
+  agent_path: string
+  instance_paths: list
+  mode_used: string         # "stub" or "guided" — which branch executed.
+  files_written: list       # absolute paths of every file the plan created or modified.
+
+steps:
+  - id: validate
+    description: |
+      Confirm ${inputs.function} is registered. Validate ${inputs.agent} slug
+      against `^[a-z][a-z0-9-]*$`. Confirm `${inputs.function}/${inputs.agent}/`
+      does not already exist. If ${inputs.mode} is provided, validate it is
+      one of {stub, guided}. If ${inputs.add-to-projects} provided, validate
+      each project exists at `projects/<slug>/`. If any are missing, abort.
+
+  - id: resolve_mode
+    description: |
+      Pick the scaffold branch by priority — first match wins:
+        1. `${inputs.mode}` (if non-empty).
+        2. `AGENT_TEAM_NO_CONFIRM=1` in env → `stub`. (Headless / CI signal.)
+        3. TTY detection: stdin is a TTY → `guided`; otherwise → `stub`.
+
+      Store the result in `${resolved_mode}` and surface it later as
+      `${outputs.mode_used}`. Print the resolved mode + the rule that won
+      (e.g., `mode=guided (TTY detected)`) so the caller can see why.
+
+  - id: scaffold_stub
+    when: ${resolved_mode} == "stub"
+    tool: bash
+    args:
+      command: bash scripts/new-agent.sh ${inputs.function} ${inputs.agent}
+    description: |
+      Delegate to `scripts/new-agent.sh` unchanged. Output must remain
+      byte-identical to invoking the script directly — this is the legacy /
+      headless escape hatch and any drift breaks reproducibility for
+      callers that already script against the stub layout. Append every
+      path the script reports as "Created:" to `${files_written}`.
+
+  - id: guided_dialogue
+    when: ${resolved_mode} == "guided"
+    description: |
+      Run the Guided Agent Creation dialogue defined in
+      `skills/chief-of-staff/SKILL.md` § "Guided Agent Creation" (P4-T02).
+      That contract owns the prompt sequence, the structured-output schema,
+      validation rules, and the on-disk write list. It produces the same
+      directory layout as `scaffold_stub` (same paths, same `.gitkeep`s),
+      but with `agent.md` sections filled in from the dialogue answers and
+      a real description in `.claude/commands/<agent>.md` instead of the
+      `TODO: fill in description` placeholder. Append every file touched
+      to `${files_written}`.
+
+  - id: resolve_projects
+    description: |
+      Branch on whether ${inputs.add-to-projects} was provided.
+      - If provided: use the list directly.
+      - If omitted: discover all live projects (every dir under `projects/`
+        that is not `_template` and does not start with `_`). If empty,
+        skip instancing and report "no live projects yet."
+        Otherwise present a multi-select via AskUserQuestion with options
+        [All projects, ...each project, None — agent stays global-only]
+        and `multiSelect: true`.
+
+  - id: instance_into_projects
+    tool: bash
+    args:
+      command: |
+        for proj in ${resolved_projects}; do
+          bash scripts/new-agent-instance.sh "$proj" ${inputs.function} ${inputs.agent}
+        done
+    description: |
+      For each resolved project, run `new-agent-instance.sh` and append the
+      instance line to `projects/<project>/CLAUDE.md` under
+      `## Active agent instances`. Append every created instance path to
+      `${files_written}`.
+
+  - id: report
+    description: |
+      Print `${outputs.mode_used}`, the global agent path, every instance
+      path, and the full `${files_written}` list.
+
+      In **stub** mode, surface the script's "Next steps" output verbatim
+      (fill `agent.md`, add subagents, configure MCPs, add at least one
+      plan, edit the slash command description) — the placeholders are
+      still empty and the caller has to finish them.
+
+      In **guided** mode, those next steps are mostly already done. Print
+      only the residual ones: wire MCPs in `.mcp.json`, write the first
+      plan in `plans/`, and review the generated `agent.md` for any
+      dialogue answers that should be refined.
+
+approval_channel: session

package/templates/scaffold/chief-of-staff/plans/create-function.yaml

@@ -0,0 +1,48 @@
+plan: create-function
+description: |
+  Add a new function category to the registry. Scaffolds the folder, stub
+  README, and optionally an EXPERT.md stub. Surfaces a soft proliferation
+  reminder before scaffolding.
+
+inputs:
+  function:
+    required: true
+    description: Function slug (lowercase, kebab-case, must not exist as a folder or in .config/functions.yaml).
+  description:
+    required: false
+    description: Free-text description of the function. If omitted, prompted.
+  has_expert:
+    required: false
+    description: Whether to scaffold an EXPERT.md stub. If omitted, prompted.
+
+outputs:
+  function_path: string
+
+steps:
+  - id: validate
+    description: |
+      Validate slug. Confirm not registered in .config/functions.yaml and no
+      top-level folder collision. Resolve ${inputs.description} and
+      ${inputs.has_expert} (prompt if absent).
+
+  - id: proliferation_reminder
+    description: |
+      Soft prompt: "Will you have 2-3 agents in this function in ~90 days?"
+      Require keypress to continue. The script's own prompt counts as the
+      confirmation gate — chief-of-staff just surfaces what the script will do.
+    approval: session
+
+  - id: execute
+    tool: bash
+    args:
+      command: bash scripts/create-function.sh ${inputs.function} --description "${inputs.description}" ${inputs.has_expert:+--with-expert}
+    description: Run the backing script.
+
+  - id: report
+    description: |
+      Print scaffolded paths. Surface post-creation reminders the script
+      prints: create #<slug> Slack channel, add SLACK_HITL_CHANNEL_<SLUG> to
+      .env, fill EXPERT.md stub if applicable, add the first agent via
+      new-agent.sh.
+
+approval_channel: session

package/templates/scaffold/chief-of-staff/plans/create-project.yaml

@@ -0,0 +1,65 @@
+plan: create-project
+description: |
+  Scaffold a new project at projects/<slug>/ and optionally instance a list of
+  agents into it. If no agent list is provided, prompt the user with a
+  multi-select of all globally-discovered agents.
+
+inputs:
+  project:
+    required: true
+    description: Project slug (lowercase, kebab-case, starts with letter, must not collide live or in _archive).
+  agents:
+    required: false
+    description: List of <function>/<agent> to instance immediately. If omitted, the cross-link prompt runs.
+
+outputs:
+  project_path: string
+  instance_paths: list
+
+steps:
+  - id: validate
+    description: |
+      Confirm cwd is repo root. Validate ${inputs.project} slug. Confirm
+      projects/${inputs.project}/ does not exist live or in _archive/projects/.
+      If ${inputs.agents} provided, validate every <function>/<agent>/ exists globally.
+      If any are missing, abort and tell the user to run create-agent first.
+
+  - id: scaffold_project
+    tool: bash
+    args:
+      command: bash scripts/new-project.sh ${inputs.project}
+    description: Create projects/<project>/ with template files.
+
+  - id: resolve_agents
+    description: |
+      Branch on whether ${inputs.agents} was provided.
+      - If provided: use the list directly.
+      - If omitted: discover all <function>/<agent>/ folders containing agent.md
+        across functions registered in .config/functions.yaml. If empty, skip
+        instancing and report "no agents exist yet — run create-agent first."
+        Otherwise present a multi-select via AskUserQuestion with options
+        [All agents, ...each discovered <function>/<agent>, None — leave project bare]
+        and multiSelect: true. Resolve "All agents" to the full list,
+        "None" or empty to an empty list.
+
+  - id: instance_agents
+    tool: bash
+    args:
+      command: |
+        for entry in ${resolved_agents}; do
+          fn="${entry%/*}"; agent="${entry#*/}"
+          bash scripts/new-agent-instance.sh ${inputs.project} "$fn" "$agent"
+        done
+    description: |
+      For each resolved agent, run new-agent-instance.sh. Script prompts
+      interactively for tool bindings declared in the agent's
+      ## Tools and bindings section. Skip with Enter or "skip" to leave
+      placeholders. After each instance, append a line to
+      projects/${inputs.project}/CLAUDE.md under ## Active agent instances.
+
+  - id: report
+    description: |
+      Print all paths created — project root + every instance — and surface
+      the instance count.
+
+approval_channel: session

package/templates/scaffold/chief-of-staff/plans/remove-agent-from-project.yaml

@@ -0,0 +1,50 @@
+plan: remove-agent-from-project
+description: |
+  Remove an agent instance from a project. Always archives (no hard delete).
+  For permanent deletion, the user can manually rm -rf the archived copy.
+  Run history and project-scoped lessons live inside the instance — deletion
+  destroys evidence the dreamer needs.
+
+inputs:
+  project:
+    required: true
+    description: Project slug.
+  function:
+    required: true
+    description: Function slug.
+  agent:
+    required: true
+    description: Agent slug.
+
+outputs:
+  archive_path: string
+
+steps:
+  - id: validate
+    description: |
+      Confirm instance exists at
+      ${inputs.function}/${inputs.agent}/projects/${inputs.project}/.
+
+  - id: confirmation
+    description: |
+      Show the planned move and CLAUDE.md update:
+
+        Will move:
+          ${inputs.function}/${inputs.agent}/projects/${inputs.project}/  →  _archive/${inputs.function}/${inputs.agent}/projects/${inputs.project}-<date>/
+        And update:
+          projects/${inputs.project}/CLAUDE.md  (remove instance from ## Active agent instances)
+        Proceed?
+
+      Wait for "proceed", "yes", "y". Abort cleanly if denied.
+    approval: session
+
+  - id: execute
+    tool: bash
+    args:
+      command: bash scripts/remove-agent-from-project.sh ${inputs.project} ${inputs.function} ${inputs.agent}
+    description: Run the backing script.
+
+  - id: report
+    description: Print the archive path and the operation log entry.
+
+approval_channel: session

package/templates/scaffold/chief-of-staff/plans/rename-project.yaml

@@ -0,0 +1,62 @@
+plan: rename-project
+description: |
+  Rename a project everywhere it appears: project root, every agent instance
+  folder, and content references in CLAUDE.md / GUIDANCE.md / config files /
+  asset-references. Does NOT auto-update lesson, run, or feedback bodies —
+  those are historical evidence reviewed manually.
+
+inputs:
+  old:
+    required: true
+    description: Current project slug (must exist at projects/<old>/).
+  new:
+    required: true
+    description: New slug (lowercase, kebab-case, must not exist live or in _archive).
+
+outputs:
+  paths_renamed: list
+  unauto_updated_files: list
+
+steps:
+  - id: validate
+    description: |
+      Confirm projects/${inputs.old}/ exists. Validate ${inputs.new} slug.
+      Confirm no collision live or archived. Find all instances at
+      <function>/<agent>/projects/${inputs.old}/ across the repo.
+
+  - id: confirmation
+    description: |
+      Show full list of folder moves AND in-file content updates:
+
+        Will rename folders:
+          projects/${inputs.old}/                                  → projects/${inputs.new}/
+          <function>/<agent>/projects/${inputs.old}/               → <function>/<agent>/projects/${inputs.new}/
+
+        Will replace project name in:
+          projects/${inputs.new}/CLAUDE.md
+          projects/${inputs.new}/GUIDANCE.md
+          <function>/*/projects/${inputs.new}/config/default.yaml         (project: ${inputs.new})
+          <function>/*/projects/${inputs.new}/asset-references.md
+
+        WILL NOT auto-update:
+          - lesson frontmatter project: fields (review manually)
+          - run/feedback frontmatter project: fields
+          - text references inside lesson, run, or feedback bodies
+
+        Proceed?
+
+      Wait for "proceed", "yes", "y". Abort cleanly if denied.
+    approval: session
+
+  - id: execute
+    tool: bash
+    args:
+      command: bash scripts/rename-project.sh ${inputs.old} ${inputs.new}
+    description: Run the backing script.
+
+  - id: report
+    description: |
+      Print renamed paths. Surface the list of files that mention ${inputs.old}
+      in their content but were NOT auto-updated, for manual review.
+
+approval_channel: session

package/templates/scaffold/chief-of-staff/plans/unarchive-project.yaml

@@ -0,0 +1,41 @@
+plan: unarchive-project
+description: |
+  Restore an archived project from _archive/ back to the live tree.
+
+inputs:
+  project:
+    required: true
+    description: Project slug to restore.
+  archive_suffix:
+    required: false
+    description: Date/disambiguator suffix when multiple archives exist (e.g., 2026-04-26-2).
+
+outputs:
+  restored_paths: list
+
+steps:
+  - id: locate
+    description: |
+      Search _archive/projects/${inputs.project}-* for matches. If multiple,
+      list them and ask which to restore (use ${inputs.archive_suffix} if
+      provided to disambiguate).
+
+  - id: validate
+    description: |
+      Confirm no naming collision with currently-live projects/instances.
+
+  - id: confirmation
+    description: |
+      Show what will move and where. Wait for "proceed", "yes", "y".
+    approval: session
+
+  - id: execute
+    tool: bash
+    args:
+      command: bash scripts/unarchive-project.sh ${inputs.project} ${inputs.archive_suffix}
+    description: Run the backing script.
+
+  - id: report
+    description: Print restored paths and operation log entry.
+
+approval_channel: session