Skip to content

Issue 11: Separate transient task instructions from keepable skills #632

Description

@gewenyu99

Issue 11: Separate transient task instructions from keepable skills

Epic: Task-queue orchestrator runner · Depends on: #624, #627

Why

The orchestrator installs a mini-skill per task — install, init, identify,
capture, error-tracking-step, build, dashboard, report — into
.claude/skills/ (via installSkillById in the executor's runTask). These are
the procedural HOW each task agent follows: transient wizard instructions, not
durable skills a user would keep for ongoing agent work.

But they land in the same .claude/skills/ directory as the linear flow's
keepable integration skill, so the keep-skills outro screen lists all eight
and offers to keep them. That is wrong twice over: it clutters the user's project
with eight one-shot instruction folders, and it frames throwaway scaffolding as
something worth keeping.

The linear flow has one durable skill (e.g. integration-nextjs-app-router) that
is genuinely worth keeping. The orchestrator has none — every skill it pulls is
scaffolding for a single run.

Scope / deliverable

  1. Install task instructions to an ephemeral location, not .claude/skills/.
    installSkillById already takes a skillsRoot override (the reference-example
    install uses .posthog-wizard/reference/). Install the per-task mini-skills
    under the run dir, e.g. .posthog-wizard/skills/<type>/, so they never touch
    .claude/skills/.
  2. Auto-delete them at run end. The whole .posthog-wizard/ working area is
    already the orchestrator's scratch space; clean up the installed task skills
    when the run finishes (success or failure), the same way the reference example
    is throwaway.
  3. Keep them out of the keep-skills screen. With the instructions no longer in
    .claude/skills/, the keep-skills step naturally has nothing orchestrator-owned
    to offer. Confirm the orchestrator arm either skips the keep-skills screen
    entirely (it installs no durable skill) or only ever surfaces a genuinely
    keepable skill, never the task instructions.

Key files

  • src/lib/programs/orchestrator/orchestrator-runner.tsrunTask installs each
    task's skills; point them at an ephemeral skillsRoot and clean up on run end.
  • src/lib/wizard-tools.tsinstallSkillById(..., skillsRoot?) already supports
    the override.
  • the keep-skills TUI step / screen — confirm it reads .claude/skills/ and so
    shows nothing once the instructions install elsewhere.

Acceptance criteria

  • An orchestrator run installs no mini-skills into .claude/skills/; the task
    instructions live under .posthog-wizard/ and are gone after the run.
  • The keep-skills outro screen does not list install, capture, build,
    etc. — it offers nothing for the orchestrator arm (or only a real keepable
    skill, if one is ever introduced).
  • With the flag off, the linear keep-skills behaviour is unchanged.
  • No leftover .posthog-wizard/skills/ after a clean run.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions