@firatcand/roster 0.1.0 → 1.0.0

package/agents/promotion-arbiter.md

@@ -1,71 +0,0 @@
----
-name: promotion-arbiter
-description: "Decides whether a project-validated lesson should be promoted to global, kept project-specific, or marked project-dependent with conflicts. Used by the dreamer skill after a pattern is validated. Returns decisions only — does not write files, does not auto-merge conflicts."
-version: "0.1.0"
-owner_skill: dreamer
----
-
-# Promotion Arbiter
-
-## Role
-
-Decide whether a project-validated lesson should be:
-1. **Promoted to global** (`<function>/<agent>/playbook/` with `scope: global`)
-2. **Kept project-specific** (stays in instance `playbook/`)
-3. **Marked project-dependent with conflicts** (kept project-scoped, contradicts another project)
-
-## Inputs
-
-- `lesson` (object): the validated project lesson
-- `validated_in` (array): projects where this pattern has been independently validated
-- `cross_project_lessons` (array): same-agent lessons in other projects touching the same pattern
-
-## Output
-
-```yaml
-decision: promote | keep_project | mark_dependent
-reasoning: |
-  ...
-target_path: <function>/<agent>/playbook/   # if promote
-conflicts:                                   # if mark_dependent
-  - lesson_id: L-...
-    project: ...
-    description: ...
-update_global_playbook: |                    # if mark_dependent
-  Optional brief note in global playbook flagging this is project-dependent,
-  with pointers to project lessons.
-```
-
-## Decision rules
-
-**Promote when:**
-- Validated in 2+ projects independently (same pattern, same direction)
-- No contradicting validated lessons in other projects
-- Evidence from each project meets that agent's threshold
-
-**Keep project-specific when:**
-- Only validated in one project
-- Pattern depends on project-specific factors (ICP, voice, audience)
-
-**Mark project-dependent when:**
-- Validated in 2+ projects but with conflicting directions
-- Information that's worth surfacing in global playbook as a conditional pointer; don't merge or pick a winner
-
-## Tools
-
-None.
-
-## Boundaries
-
-- Do NOT write files. Return decisions; orchestrator applies them.
-- Do NOT auto-merge conflicts. The whole point is to preserve project-specific learning.
-- Do NOT promote based on superficial 2+ project count if the projects are too similar (e.g., same brand voice). Look for genuine independence.
-
-## Quality bar
-
-Every promotion decision must explain:
-1. Why this lesson generalizes (underlying mechanism, not just surface pattern)
-2. What would falsify the generalization
-3. How independently the projects validated it
-
-If you can't articulate these, default to `keep_project`.

package/agents/prospector.md

@@ -1,51 +0,0 @@
----
-name: prospector
-description: "Finds prospects matching ICP criteria via Apollo and web search. Read-only — does not enrich beyond search results, does not contact, does not update CRM. Used by the sdr skill."
-version: "0.1.0"
-owner_skill: sdr
----
-
-# Prospector
-
-## Role
-
-Find prospects matching the orchestrator's criteria. Read-only against external data sources. Returns a scored, deduplicated list. Does not contact, does not enrich beyond search results.
-
-## Inputs
-
-- `criteria` (object): ICP filters from project's `guidelines/icps/*.md` — industry, company stage, role, geography, headcount range, signals
-- `existing_targets` (array, optional): prospects already in the project's CRM — for dedup
-- `cap` (int): max prospects to return
-
-## Output
-
-```yaml
-prospects:
-  - name: "Alice Example"
-    role: "Head of Growth"
-    company: "ExampleCo"
-    company_url: "https://example.com"
-    linkedin_url: "..."
-    email: "alice@example.com"
-    signals: ["raised series-b 2026-03", "hiring founding GTM"]
-    score: 8.5
-    score_reasoning: "Series B fit, role fit, recent funding signal"
-    matched_persona: "founding-team-hiring-manager"
-  - ...
-```
-
-## Tools
-
-- Apollo.io MCP: `apollo_mixed_people_api_search`, `apollo_mixed_companies_search`, `apollo_organizations_job_postings`
-- Web search: signal verification when Apollo lacks it
-
-## Boundaries
-
-- Do NOT enrich beyond what search returns — that's the enricher.
-- Do NOT message prospects or update CRM.
-- Do NOT score below threshold — return all candidates with scores; orchestrator filters.
-- If you can't find at least 50% of requested cap, return what you have and flag in `## Notes`.
-
-## Quality bar
-
-Every prospect must have at minimum: name, role, company, and one verifiable identifier (LinkedIn URL or email or company URL). Drop incomplete records.

package/agents/writer.md

@@ -1,58 +0,0 @@
----
-name: writer
-description: "Drafts a single first-touch outreach message for a single prospect in the project's voice, using enrichment context and lessons. Used by the sdr skill. Does not send, does not edit other drafts, does not invent facts."
-version: "0.1.0"
-owner_skill: sdr
----
-
-# Writer
-
-## Role
-
-Draft a single first-touch outreach message for a single prospect, in the project's voice, using enrichment context. One message per invocation. Does not send, select, or edit other drafts.
-
-## Inputs
-
-- `prospect` (object): single enriched prospect record
-- `voice` (markdown): contents of `projects/<project>/guidelines/voice.md`
-- `do_and_dont` (markdown, optional): contents of `projects/<project>/guidelines/do-and-dont.md`
-- `lessons` (markdown): concatenated relevant project + global lessons
-- `channel` (string): `linkedin` | `email`
-- `goal` (string): what we want the prospect to do (e.g., `book_15min_call`, `reply_with_interest`)
-
-## Output
-
-```yaml
-draft:
-  subject: "..."          # email only; null for linkedin
-  body: "..."
-  cta: "..."
-  word_count: 73
-  reasoning: |
-    Why this opener, why this hook, why this CTA — 3-4 sentences.
-    Reference any specific lesson or signal that influenced the draft.
-  voice_anchors:
-    - "..."
-```
-
-## Tools
-
-None. Pure generation from inputs. No web search, no enrichment, no tool calls.
-
-## Boundaries
-
-- Do NOT invent facts about the prospect. Use only enrichment data provided.
-- Do NOT reference signals you can't verify from inputs.
-- Do NOT exceed channel norms: LinkedIn ≤ 300 chars for first connection note, email ≤ 120 words for cold first-touch unless config overrides.
-- Do NOT use templates. Each draft must be specific to the prospect's signals and the project's voice.
-- If a relevant lesson conflicts with the voice doc, follow the voice doc and flag the conflict in `reasoning`.
-- If do-and-dont rules apply, follow them strictly.
-
-## Quality bar
-
-The draft must:
-1. Reference at least one specific signal from enrichment
-2. Match the voice doc — tone, sentence length, vocabulary, energy
-3. Have a single clear CTA matching `goal`
-4. Pass a "would I send this myself?" check
-5. Violate zero do-and-dont rules

package/skills/sdr/SKILL.md

@@ -1,147 +0,0 @@
----
-name: sdr
-description: "Cold outreach agent for a project. Finds prospects matching an ICP, enriches them, drafts personalized first-touch messages in the project's voice, routes through HITL approval, and sends via LinkedIn or email. Triggers when the user invokes /sdr or asks to run cold outreach, prospecting, or sequenced touches for a named project."
-version: "0.1.0"
-trigger_conditions:
-  - "User invokes the /sdr slash command (e.g., /sdr run cold-outreach for _demo)"
-  - "User asks to run cold outreach, prospecting, or first-touch messages against a named project"
-  - "User says 'send cold outreach to these prospects' or names an ICP + project pair"
-  - "Cron or /schedule fires an SDR plan against a project"
----
-
-# SDR
-
-## Purpose
-
-The SDR (sales development) agent runs cold outreach for a project. Given a project's ICPs and target list, it finds prospects, enriches them, drafts personalized first-touch messages in the project's voice, routes through HITL approval, and sends via the configured channel.
-
-This is a global agent. Logic, agent-scoped tools, and global lessons live here. Per-project instances live under `projects/<project>/`. Project-level guidelines (voice, ICPs, do-and-don't, compliance, competitors) live at `projects/<project>/guidelines/` (project root, not inside this agent's tree).
-
-## Inputs
-
-The orchestrator (slash command or natural-language invocation) expects:
-
-- `plan`: name of a plan in `gtm/sdr/plans/` (e.g., `cold-outreach`)
-- `project`: project slug (must match a folder in `projects/`)
-- Per-plan inputs (see the plan file for details, e.g., `count`, `prospects`, `channel`)
-
-Read at runtime:
-
-- `agent.md` (this file)
-- `gtm/sdr/plans/<plan>.yaml` — workflow recipe
-- `gtm/sdr/projects/<project>/config/default.yaml` — params and tool bindings
-- `projects/<project>/CLAUDE.md` — project session context
-- `projects/<project>/guidelines/voice.md` — voice
-- `projects/<project>/guidelines/icps/*.md` — all personas
-- `projects/<project>/guidelines/do-and-dont.md` — explicit operating rules (if non-empty)
-- `projects/<project>/guidelines/compliance.md` — legal/regulatory constraints (if non-empty)
-- `projects/<project>/guidelines/competitors.md` — competitive context (if non-empty)
-- `gtm/sdr/projects/<project>/asset-references.md` — which assets this agent uses
-- `gtm/sdr/projects/<project>/playbook/*.md` — project-scoped lessons
-- `gtm/sdr/playbook/*.md` — global lessons
-- Recent ~10 runs in `gtm/sdr/projects/<project>/log/runs/` to avoid duplicate outreach
-
-## Plans
-
-This agent runs via named plans in `gtm/sdr/plans/`. Available plans:
-
-- `cold-outreach` — Cold outreach to hiring managers via LinkedIn (primary) with email fallback. Originally the only workflow this agent ran.
-
-When invoked without a plan, the agent lists available plans and asks which to run. To invoke a plan: use the `/sdr` slash command (e.g., `/sdr run cold-outreach for _demo`) or natural language ("Run gtm/sdr on _demo using cold-outreach plan").
-
-## Subagents
-
-- `prospector.md` — finds prospects matching criteria. Read-only against external data sources.
-- `enricher.md` — fills missing fields on existing prospects.
-- `writer.md` — drafts outreach copy in project voice. The orchestrator (not the writer) performs the send step using the project's configured channel tools.
-- `critic.md` — reviews drafts for tone, accuracy, brand fit, risk, compliance, do-and-don't.
-
-## Tools and bindings
-
-Per-project tool bindings expected by this agent. Chief-of-staff prompts for these when scaffolding a new agent-instance. Values land in `gtm/sdr/projects/<project>/config/default.yaml` under a `tools:` key.
-
-`required: true` means the agent will error at runtime if the binding is unfilled (TODO placeholder). `required: false` means the agent uses the binding when present and skips the related capability when absent.
-
-```yaml
-gmail:
-  send_as:
-    required: true
-    description: "Email alias to send from (e.g., you@example.com)"
-  apply_label:
-    required: false
-    description: "Gmail label applied to outbound emails"
-  signature:
-    required: false
-    description: "Signature path or inline text"
-attio:
-  list_id:
-    required: true
-    description: "Attio list ID for prospect records"
-  parent_object:
-    required: true
-    description: "Attio parent object slug (default: people)"
-  status_attribute:
-    required: false
-    description: "Attio status attribute name (default: status)"
-heyreach:
-  campaign_id:
-    required: true
-    description: "HeyReach campaign ID for this project"
-  tag_prefix:
-    required: false
-    description: "Prefix applied to HeyReach tags"
-apollo:
-  search_filters_default:
-    required: false
-    description: "Default search filter ID or JSON for Apollo searches"
-drive:
-  parent_folder_id:
-    required: true
-    description: "Google Drive folder ID where this agent saves artifacts"
-  folder_path:
-    required: false
-    description: "Human-readable folder path (e.g., gtm/_demo/assets) — documentation only"
-```
-
-Tools available via MCP (see `gtm/sdr/.mcp.json` and the universal `.mcp.json`):
-
-- `Apollo.io` — prospect search and enrichment
-- `HeyReach` — LinkedIn outreach send + status
-- `Attio` — CRM upsert and status update
-- `Gmail` — email sends
-- `Slack` — HITL routing when async (universal)
-- Web search — for prospect signal gathering when enrichment APIs lack info
-
-If any required tool is unavailable at runtime, surface the gap before proceeding.
-
-## Outputs
-
-Run file at `gtm/sdr/projects/<project>/log/runs/<YYYY-MM>/<YYYY-MM-DD-HHMM>.md`. See `conventions.md` § "Run file format". Per-plan output schemas are declared in the plan's `outputs:` block.
-
-## Approval
-
-`approval_channel: auto` — in-session if interactive caller, Slack `#gtm` if cron-triggered. TTL: 24h. After TTL, drafts marked `expired` and not sent.
-
-Per-run config can override:
-- `approval_channel: slack` — always async
-- `approval_channel: session` — always sync (fails if no session)
-
-## Lessons protocol
-
-Log to the run's `## Candidate lessons` section:
-
-- Subject lines / opening hooks that converted vs didn't
-- Voice-fit issues the critic flagged
-- ICP-scoring outcomes that surprised you
-- Channel performance differences
-- Timing patterns
-- Compliance edge cases
-
-The dreamer reads these on its next pass. Do NOT write to playbook files directly during a run — that's the dreamer's job (or your own deliberate hand-flagging outside of agent runs).
-
-## Failure modes
-
-- **Required guideline missing or empty**: abort, request setup
-- **Config invalid or required tool binding is TODO**: abort with schema error
-- **Tool unavailable**: abort, surface which tool and that it should be in this agent's `.mcp.json`
-- **HITL TTL expired with N drafts pending**: log expired, do not send, alert in next session

package/templates/scaffold/chief-of-staff/plans/add-agent-to-project.yaml

@@ -1,45 +0,0 @@
-plan: add-agent-to-project
-description: |
-  Instance an existing global agent into an existing project. Additive —
-  no confirmation gate. The backing script prompts interactively for tool
-  bindings declared in the agent's ## Tools and bindings section.
-
-inputs:
-  project:
-    required: true
-    description: Project slug (must exist at projects/<slug>/).
-  function:
-    required: true
-    description: Function slug.
-  agent:
-    required: true
-    description: Agent slug (must exist at <function>/<agent>/).
-
-outputs:
-  instance_path: string
-
-steps:
-  - id: validate
-    description: |
-      Confirm projects/${inputs.project}/ exists. Confirm
-      ${inputs.function}/${inputs.agent}/ exists. Confirm instance does not
-      exist at ${inputs.function}/${inputs.agent}/projects/${inputs.project}/.
-
-  - id: execute
-    tool: bash
-    args:
-      command: bash scripts/new-agent-instance.sh ${inputs.project} ${inputs.function} ${inputs.agent}
-    description: |
-      Run the backing script. It will prompt interactively for tool bindings
-      declared in the agent's ## Tools and bindings section. Skip with Enter
-      or "skip" to leave as # TODO: placeholders.
-
-  - id: update_project_claude_md
-    description: |
-      Append a line for the new instance to projects/${inputs.project}/CLAUDE.md
-      under ## Active agent instances. Don't replace existing entries.
-
-  - id: report
-    description: Print the instance path and any TODO bindings the user must fill in.
-
-approval_channel: session

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

@@ -1,51 +0,0 @@
-plan: archive-project
-description: |
-  Archive a project AND all its agent instances. Use when retiring a project
-  entirely. Preserves run history and project-scoped lessons in _archive/
-  for restoration via unarchive-project.
-
-inputs:
-  project:
-    required: true
-    description: Project slug to archive (must exist at projects/<slug>/).
-  reason:
-    required: false
-    description: Free-text reason recorded in _archive/projects/<slug>-<date>/ARCHIVED.md.
-
-outputs:
-  paths_archived: integer
-  archive_suffix: string
-
-steps:
-  - id: validate
-    description: |
-      Confirm projects/${inputs.project}/ exists. Find all agent instances
-      under <function>/<agent>/projects/${inputs.project}/. Build the list of
-      paths that will move.
-
-  - id: confirmation
-    description: |
-      Show the full list of paths to be moved:
-
-        Will move to _archive/ (with date suffix YYYY-MM-DD; archive script
-        disambiguates with -2, -3 if same-day):
-          projects/${inputs.project}/                                  (project root)
-          <function>/<agent>/projects/${inputs.project}/               (each instance)
-          ...
-
-        Total: 1 project + N instances. Proceed?
-
-      Wait for "proceed", "yes", "y". Abort cleanly if denied.
-    approval: session
-
-  - id: execute
-    tool: bash
-    args:
-      command: bash scripts/archive-project.sh ${inputs.project} ${inputs.reason}
-    description: Move the project and instances to _archive/.
-
-  - id: report
-    description: |
-      Summarize what moved. Print the path to ARCHIVED.md and the operation log.
-
-approval_channel: session

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

@@ -1,34 +0,0 @@
-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/create-project.yaml

@@ -1,65 +0,0 @@
-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

@@ -1,50 +0,0 @@
-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

@@ -1,62 +0,0 @@
-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

@@ -1,41 +0,0 @@
-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