@triclaps/cli 0.0.4 → 0.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/index.js +12085 -9067
  2. package/package.json +1 -2
  3. package/skills/assignment-kickoff-orchestration/SKILL.md +0 -53
  4. package/skills/assignment-kickoff-orchestration/agents/openai.yaml +0 -4
  5. package/skills/assignment-kickoff-orchestration/references/kickoff-checklist.md +0 -23
  6. package/skills/chat-task-delivery/SKILL.md +0 -33
  7. package/skills/chat-task-delivery/agents/openai.yaml +0 -4
  8. package/skills/claps-cli/SKILL.md +0 -203
  9. package/skills/claps-cli/agents/openai.yaml +0 -4
  10. package/skills/claps-cli/references/capabilities.md +0 -96
  11. package/skills/execution-context-recovery/SKILL.md +0 -51
  12. package/skills/execution-context-recovery/agents/openai.yaml +0 -4
  13. package/skills/git-delivery/SKILL.md +0 -41
  14. package/skills/git-delivery/agents/openai.yaml +0 -4
  15. package/skills/manifest.json +0 -324
  16. package/skills/merge-closeout/SKILL.md +0 -46
  17. package/skills/merge-closeout/agents/openai.yaml +0 -4
  18. package/skills/planning-baseline/SKILL.md +0 -43
  19. package/skills/planning-baseline/agents/openai.yaml +0 -4
  20. package/skills/planning-baseline/references/state-examples.md +0 -75
  21. package/skills/planning-session-convergence/SKILL.md +0 -50
  22. package/skills/planning-session-convergence/agents/openai.yaml +0 -4
  23. package/skills/preview-gateway/SKILL.md +0 -58
  24. package/skills/preview-gateway/agents/openai.yaml +0 -4
  25. package/skills/project-admin/SKILL.md +0 -44
  26. package/skills/project-admin/agents/openai.yaml +0 -4
  27. package/skills/repo-binding-closure/SKILL.md +0 -54
  28. package/skills/repo-binding-closure/agents/openai.yaml +0 -4
  29. package/skills/repo-binding-closure/references/execution-lane-checklist.md +0 -27
  30. package/skills/review-handoff/SKILL.md +0 -40
  31. package/skills/review-handoff/agents/openai.yaml +0 -4
  32. package/skills/roadmap.json +0 -127
  33. package/skills/task-admin/SKILL.md +0 -59
  34. package/skills/task-admin/agents/openai.yaml +0 -4
  35. package/skills/task-contract-draft/SKILL.md +0 -80
  36. package/skills/task-contract-draft/agents/openai.yaml +0 -4
  37. package/skills/task-detail-lookup/SKILL.md +0 -51
  38. package/skills/task-detail-lookup/agents/openai.yaml +0 -4
  39. package/skills/task-pool-triage/SKILL.md +0 -56
  40. package/skills/task-pool-triage/agents/openai.yaml +0 -4
  41. package/skills/task-stage-summary-backfill/SKILL.md +0 -75
  42. package/skills/task-stage-summary-backfill/agents/openai.yaml +0 -4
  43. package/skills/user-story-delivery/SKILL.md +0 -76
  44. package/skills/user-story-delivery/agents/openai.yaml +0 -4
  45. package/skills/workspace-bootstrap/SKILL.md +0 -41
  46. package/skills/workspace-bootstrap/agents/openai.yaml +0 -4
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@triclaps/cli",
3
- "version": "0.0.4",
3
+ "version": "0.0.6",
4
4
  "type": "module",
5
5
  "bin": {
6
6
  "claps-cli": "index.js"
@@ -11,7 +11,6 @@
11
11
  "license": "MIT",
12
12
  "files": [
13
13
  "index.js",
14
- "skills",
15
14
  "adapters",
16
15
  "README.md"
17
16
  ],
@@ -1,53 +0,0 @@
1
- ---
2
- name: assignment-kickoff-orchestration
3
- description: >
4
- Use this skill when CLAPS already has a task, candidate assignee, or prepared
5
- execution_context, but the real kickoff contract is still incomplete. This
6
- covers confirming ownership, turning prepared context into started work,
7
- setting the first heartbeat expectations, and keeping assignment state in sync
8
- with chat and task views.
9
- tags:
10
- - assignment
11
- - execution
12
- - kickoff
13
- ---
14
-
15
- # assignment-kickoff-orchestration
16
-
17
- Use this skill when the system is stuck between "someone should do this" and "execution has actually started."
18
-
19
- ## Goals
20
-
21
- - Turn assignment intent into an explicit execution kickoff.
22
- - Keep assignee, execution context, and operator expectations aligned.
23
- - Avoid prepared branches or worktrees sitting idle with no owner or next heartbeat.
24
-
25
- ## Flow
26
-
27
- 1. Read assignment readiness
28
- Check the task status, preferred assignee, actual assignee, repo binding, execution_context state, and whether the branch/worktree is only `prepared` or already active.
29
-
30
- 2. Confirm the kickoff contract
31
- Resolve the missing pieces:
32
- - who owns the task now
33
- - whether the assignee accepts the work
34
- - what the first execution step is
35
- - when progress or heartbeat should come back
36
- - which validation or preview target defines "started correctly"
37
-
38
- 3. Move from prepared to active
39
- Patch the assignment or execution state so the kickoff is reflected in CLAPS instead of only implied by a branch name or local workspace.
40
-
41
- 4. Set the first reporting loop
42
- Leave a short kickoff summary that tells the operator what just started, what evidence should arrive next, and what blocker would prevent the first heartbeat.
43
-
44
- 5. Hand off to execution
45
- Once ownership and kickoff are explicit, continue into `workspace-bootstrap`, runtime execution, or `execution-context-recovery` if the contract still breaks.
46
-
47
- ## Guidance
48
-
49
- - Do not treat "preferred assignee" as equivalent to accepted ownership.
50
- - Do not leave a `prepared` execution_context hanging without a visible next turn.
51
- - If the assignee is wrong, fix ownership before starting work.
52
- - If kickoff is blocked on repo binding or planning convergence, route backward explicitly instead of silently stalling.
53
- - Use `references/kickoff-checklist.md` to verify that assignment, execution context, and first-heartbeat expectations actually line up before declaring work started.
@@ -1,4 +0,0 @@
1
- interface:
2
- display_name: "assignment-kickoff-orchestration"
3
- short_description: "Turn prepared CLAPS work into an explicit assignee kickoff"
4
- default_prompt: "Use assignment-kickoff-orchestration when CLAPS has a task and possibly a prepared execution context, but still needs explicit ownership, kickoff state, and the first heartbeat contract before real execution starts."
@@ -1,23 +0,0 @@
1
- # Assignment Kickoff Checklist
2
-
3
- Use this note when a task looks ready, but CLAPS still needs an explicit kickoff contract instead of an implied one.
4
-
5
- ## Preconditions
6
-
7
- - The task has a real assignee or a pending ownership decision.
8
- - Repo binding is coherent enough to start work.
9
- - A prepared `execution_context` exists or the missing fields are clearly called out.
10
-
11
- ## Kickoff contract
12
-
13
- - Confirm who owns the task now.
14
- - Confirm whether the assignee has accepted the work.
15
- - Name the first execution step.
16
- - Name the first heartbeat or update expectation.
17
- - Name the validation or preview signal that proves kickoff succeeded.
18
-
19
- ## Status write-back
20
-
21
- - Move assignment and `execution_context` from implied/prepared to explicit started state.
22
- - Leave a short kickoff summary that tells operators what evidence should arrive next.
23
- - If kickoff fails, record the blocker instead of leaving the task in a misleading active state.
@@ -1,33 +0,0 @@
1
- ---
2
- name: chat-task-delivery
3
- description: >
4
- Use this skill when a CLAPS conversation should move from clarification into
5
- tracked delivery, repo-backed execution, progress reporting, and review
6
- handoff. This also covers requests that mention claps-cli or
7
- claps-execution-style execution behavior.
8
- ---
9
-
10
- # chat-task-delivery
11
-
12
- Use this as the primary CLAPS operating skill when a conversation should move from clarification to tracked work to repo-backed delivery.
13
-
14
- ## Core capabilities
15
-
16
- - Ask focused follow-up questions before execution when the desired experience, validation plan, acceptance criteria, edge cases, or boundaries are still unclear.
17
- - Create or update tracked workflow tasks from chat instead of leaving delivery work buried in free-form conversation.
18
- - In group channels, task candidates should enter the weighted task pool first: human votes count as 2, agent votes count as 1, and dispatch starts only after the approval threshold is met.
19
- - Create files and docs inside the repo when they are part of the implementation or review evidence.
20
- - Prepare a worktree and branch, execute the coding runtime, commit changes, push the branch, and open a merge request when the provider path supports it.
21
- - Proactively post task updates, blockers, logs, links, and handoff evidence so humans can review what happened.
22
-
23
- ## Recommended flow
24
-
25
- 1. Clarify the task and ask concrete follow-up questions if the story is not ready.
26
- 2. Create or patch the workflow task so the work is tracked in CLAPS.
27
- 3. Break the work into execution steps, docs, data flow, and interaction notes when the task needs structure.
28
- 4. Implement in the prepared workspace and create the supporting repo files needed for delivery.
29
- 5. Run self-checks with the right gstack review angle when available: `plan-eng-review`, `plan-design-review`, `design-review`, `review`, `qa`, and `document-release`.
30
- 6. Deliver with concise evidence: what changed, how it was validated, branch / commit / MR context, and remaining risks.
31
-
32
- Use `claps-cli skill user-story-delivery` when the task needs the stricter story-confirmation workflow.
33
- Use `claps-cli skill preview-gateway` when local UI work needs a shareable preview URL.
@@ -1,4 +0,0 @@
1
- interface:
2
- display_name: "chat-task-delivery"
3
- short_description: "Drive CLAPS work from chat clarification through repo delivery"
4
- default_prompt: "Use chat-task-delivery to clarify work, create or update tracked tasks, execute in the repo, and hand off review evidence."
@@ -1,203 +0,0 @@
1
- ---
2
- name: claps-cli
3
- description: >
4
- Use this skill when the user asks about claps-cli, CLAPS agent runtime setup,
5
- chat-to-task execution, task creation/update/delivery, repo-backed execution,
6
- branch/worktree/commit flow, preview exposure, or how CLAPS agents should
7
- proactively clarify scope, create files, ship code, and drive work to review.
8
- ---
9
-
10
- # claps-cli
11
-
12
- `claps-cli` is the execution runtime for CLAPS. It turns imported agents into chat-first workers that can clarify work in DM/channel conversations, create or update tracked tasks, execute inside repo-backed workspaces, and hand off delivery evidence for review.
13
-
14
- In the current repo, the chat control plane can also directly mutate visible tasks in the same conversation/project: patch title/summary/description/priority, update workflow, merge duplicate tasks into a canonical task, assign a task to an agent, start a task immediately, and transition supported task statuses such as `blocked` or `cancelled`.
15
-
16
- Use this skill when the user wants help with any of these:
17
-
18
- - registering or bootstrapping a CLAPS agent
19
- - running the worker loop
20
- - turning chat into tracked work
21
- - asking better follow-up questions before execution
22
- - creating files or docs during delivery
23
- - preparing branches and worktrees
24
- - committing, pushing, and opening merge requests
25
- - exposing a local preview through the CLAPS gateway
26
- - minting a human dev session token for explicit project/task admin commands
27
- - listing, creating, archiving, or repo-binding a project through the CLI
28
- - creating, reviewing, transitioning, or soft-deleting a task through the CLI
29
- - running a single health check that validates env, API reachability, runtime assets, and workflow skill wiring
30
- - auditing whether the canonical CLAPS workflow skills are present and wired correctly
31
- - discovering the right checked-in skill from an alias, trigger phrase, or summary fragment
32
- - running gstack review skills from different roles or perspectives
33
- - proactively posting progress, blockers, and delivery evidence
34
-
35
- ## Command surface
36
-
37
- Core commands:
38
-
39
- ```bash
40
- claps-cli session login [--email <email>] [--display-name <name>] [--org-id <id>] [--org-slug <slug>] [--json] [--api-base-url <url>]
41
- claps-cli projects [--json] [--session-token <token>] [--api-base-url <url>]
42
- claps-cli project get --project-id <project-id> [--json] [--session-token <token>] [--api-base-url <url>]
43
- claps-cli project create --name <name> [--slug <slug>] [--description <text>] [--owner-member-id <member-id>] [--default-priority <critical|high|medium|low>] [--json] [--session-token <token>] [--api-base-url <url>]
44
- claps-cli project archive --project-id <project-id> [--json] [--session-token <token>] [--api-base-url <url>]
45
- claps-cli project repo-binding get --project-id <project-id> [--json] [--session-token <token>] [--api-base-url <url>]
46
- claps-cli project repo-binding set --project-id <project-id> --repo-owner <owner> --repo-name <name> --repo-url <url> [--provider <github|github_enterprise|gitlab|gitlab_selfhost>] [--default-branch <branch>] [--root-path <path>] [--is-monorepo <true|false>] [--auth-type <none|token|oauth|app>] [--json] [--session-token <token>] [--api-base-url <url>]
47
- claps-cli register --api-base-url <url> --org-slug <slug> --runtime <runtime> --external-key <key> --name <name> [--workspace-path <path>] [--capability-summary <text>] [--save-token]
48
- claps-cli run
49
- claps-cli task get --task-id <task-id> [--json] [--session-token <token>] [--api-base-url <url>]
50
- claps-cli task create --project-id <project-id> --title <title> [--summary <text>] [--description <text>] [--priority <critical|high|medium|low>] [--reviewer-member-id <member-id>] [--definition-of-done <text>] [--acceptance-checklist <item1,item2>] [--context-links <item1,item2>] [--output-requirements <item1,item2>] [--depends-on-task-ids <id1,id2>] [--due-at <iso>] [--start-after <iso>] [--auto-assign-agent-id <agent-id>] [--auto-assign-instructions <text>] [--json] [--session-token <token>] [--api-base-url <url>]
51
- claps-cli task delete --task-id <task-id> [--json] [--session-token <token>] [--api-base-url <url>]
52
- claps-cli task transition --task-id <task-id> --to-status <status> [--note <text>] [--json] [--session-token <token>] [--api-base-url <url>]
53
- claps-cli task review --task-id <task-id> --decision <approved|changes_requested> [--note <text>] [--json] [--session-token <token>] [--api-base-url <url>]
54
- claps-cli task stage list --task-id <task-id> [--json] [--session-token <token>] [--api-base-url <url>]
55
- claps-cli task stage set --task-id <task-id> --key <stage-key> [--title <text>] [--kind <planning|execution|review|delivery|custom>] [--order <int>] [--status <pending|in_progress|blocked|done|waived> --summary <text>] [--evidence <item1,item2>] [--append-evidence <true|false>] [--started-at <iso>] [--completed-at <iso>] [--assignment-id <assignment-id>] [--json] [--session-token <token>] [--api-base-url <url>]
56
- claps-cli task stage complete --task-id <task-id> --key <stage-key> --summary <text> [--evidence <item1,item2>] [--assignment-id <assignment-id>] [--json] [--session-token <token>] [--api-base-url <url>]
57
- claps-cli task stage block --task-id <task-id> --key <stage-key> --summary <text> [--assignment-id <assignment-id>] [--json] [--session-token <token>] [--api-base-url <url>]
58
- claps-cli task stage reopen --task-id <task-id> --key <stage-key> --summary <text> [--status <pending|in_progress>] [--assignment-id <assignment-id>] [--json] [--session-token <token>] [--api-base-url <url>]
59
- claps-cli task review-result submit --task-id <task-id> [--review-result-json <json>] [--decision <pass|remediate|escalate>] [--summary <text>] [--quality-completeness <high|medium|low>] [--quality-confidence <high|medium|low>] [--quality-risk <high|medium|low>] [--next-action <deliver|remediate|await_human>] [--next-action-summary <text>] [--stage-checks-json <json>] [--requirement-checks-json <json>] [--validations-json <json>] [--assignment-id <assignment-id>] [--json] [--session-token <token>] [--api-base-url <url>]
60
- claps-cli task contract-draft submit --request-id <request-id> --draft-json <json> [--json] [--session-token <token>] [--api-base-url <url>]
61
- claps-cli task stage-summary-backfill submit --request-id <request-id> --stage-summaries-json <json> [--json] [--session-token <token>] [--api-base-url <url>]
62
- claps-cli task review-readiness --task-id <task-id> [--json] [--session-token <token>] [--api-base-url <url>]
63
- claps-cli task delivery-readiness --task-id <task-id> [--json] [--session-token <token>] [--api-base-url <url>]
64
- claps-cli task remediation-budget --task-id <task-id> [--max-attempts <int>] [--json] [--session-token <token>] [--api-base-url <url>]
65
- claps-cli tasks --project-id <project-id> [--json] [--session-token <token>] [--api-base-url <url>]
66
- claps-cli skills [--search <text>] [--tag <tag[,tag2]>] [--match <all|any>] [--category <all|runtime|workflow|draft>]
67
- claps-cli skills audit
68
- claps-cli doctor [--runtime <runtime>] [--api-base-url <url>]
69
- claps-cli skill project-admin
70
- claps-cli skill chat-task-delivery
71
- claps-cli skill task-admin
72
- claps-cli skill user-story-delivery
73
- claps-cli skill planning-baseline
74
- claps-cli skill review-handoff
75
- claps-cli preview expose --app-slug <slug> --port <port> [--name <name>] [--local-host <host>] [--api-base-url <url>]
76
- ```
77
-
78
- Read [references/capabilities.md](references/capabilities.md) when you need the exact current capability map or the repo/runtime boundary.
79
-
80
- When you already know the `task.id` and need the authoritative current snapshot, prefer `claps-cli task get --task-id <task-id>` so you can answer with the exact task status, workflow, project, and linked repo binding instead of inferring from the broader project task list. This command accepts either `--session-token` / `CLAPS_SESSION_TOKEN` or `CLAPS_AGENT_TOKEN`.
81
-
82
- When a channel turn only shows the recent open-task window, use `claps-cli tasks --project-id <project-id>` with the `project.id` from `<claps_turn_context>` to fetch the full project task list. This command accepts either `--session-token` / `CLAPS_SESSION_TOKEN` or `CLAPS_AGENT_TOKEN`.
83
-
84
- When the agent or operator wants the explicit coarse stage ledger instead of inferring from `workflow.phase`, prefer `claps-cli task stage list --task-id <task-id>`. Use the `task stage set|complete|block|reopen` commands to maintain the coarse `planning / execution / review / delivery` ledger directly. Whenever the stage status changes, include a non-empty `--summary`. These stage mutations accept a human session token, and they also accept `CLAPS_AGENT_TOKEN` when the caller passes the current `--assignment-id`.
85
-
86
- When the work should stay skill-driven instead of runtime-hardcoded, prefer the explicit soft-guardrail primitives over hidden flow logic:
87
-
88
- - `claps-cli task review-readiness --task-id <task-id>`
89
- - `claps-cli task delivery-readiness --task-id <task-id>`
90
- - `claps-cli task remediation-budget --task-id <task-id> [--max-attempts <int>]`
91
- - `claps-cli task review-result submit --task-id <task-id> ...`
92
-
93
- When CLAPS routes a narrow internal helper request to one agent, prefer the explicit request-family submit primitives instead of free-form replies:
94
-
95
- - `claps-cli task contract-draft submit --request-id <request-id> --draft-json <json>`
96
- - `claps-cli task stage-summary-backfill submit --request-id <request-id> --stage-summaries-json <json>`
97
-
98
- When the operator wants explicit project or task mutations outside chat control lines, mint a human token first with `claps-cli session login` and pass it back via `--session-token <token>` or `CLAPS_SESSION_TOKEN`.
99
-
100
- ## Operating model
101
-
102
- ### 1. Chat first
103
-
104
- When an agent receives a DM or channel turn, default to clarifying the work before execution.
105
-
106
- - Ask focused follow-up questions if the desired experience, validation plan, acceptance criteria, edge cases, or out-of-scope boundaries are still ambiguous.
107
- - Keep the questions concrete and decision-driving.
108
- - If no extra reply is needed, return the no-reply token instead of adding noise.
109
-
110
- ### 2. Turn conversations into tracked work
111
-
112
- When the request should become formal delivery work:
113
-
114
- - create a workflow task from the conversation
115
- - directly mutate an existing visible task when that is the shortest correct path
116
- - in channel/group-chat flows, follow the runtime's dispatch mode
117
- - the default runtime mode now creates and dispatches channel work directly once the task is ready
118
- - when the optional channel task pool is enabled, use the weighted voting flow instead
119
- - use `user-story-delivery` when the work is story-driven
120
- - keep the task workflow current as the story moves through confirmation, breakdown, execution, self-check, and delivery
121
- - if another agent should continue next, explicitly hand off to that agent instead of relying only on queue order
122
- - when cleaning up duplicate or mistaken tasks, prefer updating or merging the visible existing task instead of creating a replacement
123
-
124
- ### 3. Execute in a repo-backed workspace
125
-
126
- When repo context exists, `claps-cli` can prepare a worktree and branch, run the coding agent inside that workspace, and then submit the result.
127
-
128
- Expected delivery behavior:
129
-
130
- - create the necessary files, docs, and implementation artifacts in the repo
131
- - respect the task acceptance checklist and definition of done
132
- - keep progress moving with intermediate task updates
133
- - when CLAPS has already dispatched a repo-backed assignment, that assignment is explicit authorization to stage, commit, and push once the implementation and minimal validation evidence are ready
134
- - commit and push changes when there is real work to ship
135
- - open a merge request when the provider path supports it
136
-
137
- ### 4. Self-check from multiple angles
138
-
139
- Before delivery, use gstack-style review passes when available. Choose the smallest relevant set:
140
-
141
- - `planning-baseline` when project chat needs a planning baseline before execution
142
- - `plan-ceo-review` for ambition / product framing
143
- - `plan-eng-review` for architecture and edge cases
144
- - `plan-design-review` for pre-build UX critique
145
- - `design-review` for implemented UI polish
146
- - `review` for diff-level code review
147
- - `qa` for browser or end-to-end verification
148
- - `review-handoff` when the remaining work is packaging validation evidence and routing the next reviewer
149
- - `document-release` when shipped behavior changed and docs must match
150
-
151
- Default review-gate mapping:
152
-
153
- - `eng_review` -> `review`
154
- - `design_review` -> `design-review`
155
- - `qa` -> `qa`
156
-
157
- Before delivery handoff, the agent or workflow skill should decide which review passes to run, call the explicit `task review-readiness`, `task delivery-readiness`, and `task remediation-budget` primitives, and then persist the structured outcome with `task review-result submit`.
158
- Use different roles only when they materially improve confidence. Do not add ceremonial review steps.
159
- For blank or nearly blank repos, do the first implementation pass before opening `review`, `design-review`, or `qa`; those are closeout tools, not a substitute for starting the build.
160
- Once a user-story task is already in `task_breakdown` or `execution`, do not reopen story-confirmation work unless the task brief is contradictory or clearly missing a critical constraint.
161
-
162
- ### Runtime health checks
163
-
164
- Use `claps-cli doctor` when you need one summary before blaming the agent runtime.
165
-
166
- - Verify `CLAPS_AGENT_TOKEN`, runtime selection, and registration-related env presence.
167
- - Probe `GET /health` on the configured API base URL.
168
- - Check whether the managed runtime skill injection is healthy for the selected runtime.
169
- - Re-run the canonical workflow skill audit so help text and checked-in assets do not silently drift.
170
-
171
- ### 5. Deliver with evidence
172
-
173
- A good CLAPS delivery should leave behind:
174
-
175
- - task updates showing progress or blockers
176
- - artifacts or repo files that capture plans, reports, screenshots, logs, or handoff notes
177
- - branch / commit / merge request context when code changed
178
- - a short final summary of what changed, how it was validated, and what still needs human review
179
-
180
- For small static or single-page web apps, prefer a light validation path:
181
-
182
- - in blank or nearly blank repos, create the first runnable product files before debating optional validation tooling
183
- - in blank or nearly blank repos, make the first successful repo change early instead of holding one giant bootstrap patch in your head
184
- - prefer a few small file-by-file patches over one monolithic patch when bootstrapping from scratch
185
- - create the main product files first; update `README` and validation notes only after the runnable files exist
186
- - do not bundle the first app scaffold, `README` rewrite, and validation note into one giant patch
187
- - if an `apply_patch` attempt fails, immediately retry with a smaller single-file or single-concern patch instead of spending more turns re-planning
188
- - run the smallest smoke check that proves the acceptance criteria
189
- - avoid inventing a large temporary QA harness if the repo does not already use one
190
- - capture the validation result in a checked-in note such as `docs/validation.md`
191
- - move to `git-delivery` once code changes and minimal validation evidence are ready
192
- - treat the app files, updated README, and one concise validation note as the default delivery package for bootstrap repos
193
- - avoid creating extra closeout artifacts such as `docs/review-handoff.md` unless the task explicitly asks for them or a reviewer cannot inspect the repo without them
194
-
195
- ## Guidance
196
-
197
- - Prefer tracked tasks over long free-form execution threads.
198
- - Prefer `vote` or `idle` over speaking for the sake of speaking in multi-agent channels.
199
- - Prefer specific follow-up questions over guessing.
200
- - Prefer concrete repo changes and review evidence over vague “done” claims.
201
- - If repo binding is missing, surface that blocker clearly instead of pretending execution can proceed.
202
- - If preview or UI validation is needed, use the preview gateway and then run the relevant gstack review/QA skill.
203
- - If the user wants deterministic operator actions instead of chat-driven workflow mutation, hand off to `project-admin`, `task-admin`, or `task-detail-lookup` rather than overloading the broader `claps-cli` skill.
@@ -1,4 +0,0 @@
1
- interface:
2
- display_name: "claps-cli"
3
- short_description: "Run CLAPS onboarding, daemon, chat-to-task delivery, and review handoff flows"
4
- default_prompt: "Use claps-cli to onboard agents, manage and diagnose the detached worker lifecycle, inspect daemon logs, create or update tracked tasks, execute inside repo-backed workspaces, and deliver with progress plus review evidence."
@@ -1,96 +0,0 @@
1
- # claps-cli Capability Map
2
-
3
- This file is the compact reference for what `claps-cli` currently supports in this repo.
4
-
5
- ## Current command surface
6
-
7
- - `claps-cli register`
8
- - `claps-cli run`
9
- - `claps-cli session login`
10
- - `claps-cli projects`
11
- - `claps-cli project get`
12
- - `claps-cli project create`
13
- - `claps-cli project archive`
14
- - `claps-cli project repo-binding get`
15
- - `claps-cli project repo-binding set`
16
- - `claps-cli task get --task-id <task-id> [--json] [--session-token <token>]`
17
- - `claps-cli task create`
18
- - `claps-cli task delete`
19
- - `claps-cli task transition`
20
- - `claps-cli task review`
21
- - `claps-cli task stage list`
22
- - `claps-cli task stage set`
23
- - `claps-cli task stage complete`
24
- - `claps-cli task stage block`
25
- - `claps-cli task stage reopen`
26
- - `claps-cli task review-result submit`
27
- - `claps-cli task contract-draft submit`
28
- - `claps-cli task stage-summary-backfill submit`
29
- - `claps-cli task review-readiness`
30
- - `claps-cli task delivery-readiness`
31
- - `claps-cli task remediation-budget`
32
- - `claps-cli tasks --project-id <project-id> [--json] [--session-token <token>]`
33
- - `claps-cli daemon start`
34
- - `claps-cli daemon status`
35
- - `claps-cli daemon stop`
36
- - `claps-cli daemon logs`
37
- - `claps-cli skills`
38
- - `claps-cli skills audit`
39
- - `claps-cli doctor`
40
- - `claps-cli skill <name>`
41
- - `claps-cli version`
42
- - `claps-cli sync-runtime --runtime <runtime> [--check]`
43
- - `claps-cli preview expose`
44
-
45
- ## Current execution abilities
46
-
47
- - Register or bootstrap an imported agent against the CLAPS API
48
- - Mint a human dev session token for explicit project/task administration
49
- - Save agent env defaults during registration and start the detached daemon by default
50
- - Start a detached background worker and inspect or stop it without manual process management
51
- - Inspect recent detached worker output without opening the daemon metadata directory manually
52
- - Wait on bootstrap claim before entering the worker loop when the runtime is launched with a bootstrap token
53
- - Poll the agent inbox and process `assignment_created` and `conversation_turn`
54
- - Run a one-shot doctor check for env presence, API `/health`, detached daemon lifecycle, runtime assets, and workflow skill wiring
55
- - Ask clarifying questions in chat before execution
56
- - Fetch the full current detail snapshot for one known task id, including project metadata and repo binding, with either a human session token or an agent token
57
- - Fetch the full task list for a specific project when the channel turn context only includes the recent open-task window, with either a human session token or an agent token
58
- - List projects from the current workspace snapshot
59
- - Create a project, archive a project, and read or upsert project repo binding through explicit CLI commands
60
- - Create a task, soft-delete a task, transition task status, and review a task through explicit CLI commands
61
- - Read and maintain the coarse task stage ledger through explicit CLI primitives instead of only inferring from `workflow.phase`
62
- - Persist structured review results plus soft guardrail checks for review readiness, delivery readiness, and remediation budget
63
- - Complete internal agent request write-back flows for task contract drafting and stage summary backfill
64
- - Create workflow-backed tasks from conversation replies
65
- - Dispatch channel-created tasks directly by default
66
- - Optionally route channel-created task candidates through a weighted task pool when that runtime feature flag is enabled
67
- - Patch an existing task workflow from follow-up conversation replies
68
- - Patch an existing visible task's title, summary, description, and priority from conversation replies
69
- - Merge a visible duplicate task into a canonical task and cancel the duplicate in the same chat turn
70
- - Assign a visible task directly to an agent from chat
71
- - Start a visible backlog task directly from chat without creating a replacement task
72
- - Transition a visible task through the supported runtime statuses from chat
73
- - Create and refine planning baselines from project chat
74
- - Explicitly nominate follow-up agents for the next turn in a channel round
75
- - Prepare repo workspaces with clone + worktree + branch
76
- - Run Codex / Claude Code / OpenClaw inside the prepared workspace
77
- - Post task progress updates while execution is running
78
- - Create delivery artifacts such as logs, links, and handoff summaries
79
- - Commit and push code changes
80
- - Open a GitLab merge request when the repo path supports it
81
- - Register and expose a local preview app through the CLAPS gateway
82
- - Surface draft checked-in skills that are not yet canonicalized, so the repo-level skill backlog stays visible during hardening
83
-
84
- ## Review angles to prefer
85
-
86
- - `review-handoff`
87
- - `plan-eng-review`
88
- - `plan-design-review`
89
- - `design-review`
90
- - `review`
91
- - `qa`
92
- - `document-release`
93
-
94
- ## Important boundary
95
-
96
- The chat/task execution path and detached daemon lifecycle are implemented and tested. The repo/PR closure path exists, but the broader product still treats it as an actively hardening workflow rather than a fully finished product surface.
@@ -1,51 +0,0 @@
1
- ---
2
- name: execution-context-recovery
3
- description: >
4
- Use this skill when CLAPS already knows the task and repo binding, but the
5
- execution_context needed for safe execution is missing, stale, contradictory,
6
- or only implied in chat. This covers branch, base branch, worktree path,
7
- runtime target, and the handoff from "prepared" context into actual kickoff.
8
- tags:
9
- - execution
10
- - recovery
11
- - runtime
12
- ---
13
-
14
- # execution-context-recovery
15
-
16
- Use this skill when execution is blocked because CLAPS knows what should be built, but not yet the exact execution lane state needed to run it safely.
17
-
18
- ## Goals
19
-
20
- - Recover or repair a stable `execution_context` instead of re-deriving branch and worktree choices from free-form chat.
21
- - Keep repo binding, assignment state, and execution metadata aligned before runtime kickoff.
22
- - Leave a reusable `prepared` execution payload behind so later worker steps do not ask the same setup questions again.
23
-
24
- ## Flow
25
-
26
- 1. Read the current execution lane state
27
- Collect the task, assignment, repo binding, current agent workspace path, and any existing `execution_context` already stored in CLAPS.
28
-
29
- 2. Isolate the missing execution fields
30
- Call out exactly which execution fields are absent or contradictory:
31
- - agent runtime or workspace target
32
- - branch and base branch
33
- - worktree path or clone root
34
- - validation command or preview surface
35
- - kickoff readiness versus follow-up repair
36
-
37
- 3. Ask only the questions that unblock execution
38
- If the execution contract is incomplete, ask short questions that resolve the missing branch, worktree, runtime, or validation choices instead of guessing.
39
-
40
- 4. Write the repaired context back
41
- Patch or create the `execution_context` so CLAPS has one coherent record for the execution lane, ideally reaching an explicit `prepared` state.
42
-
43
- 5. Hand off to execution
44
- Once the context is coherent, move into `workspace-bootstrap` or the worker kickoff path with the recovered execution metadata.
45
-
46
- ## Guidance
47
-
48
- - Treat `execution_context` as a durable contract, not just a UI preview.
49
- - Prefer repairing the existing record over creating multiple conflicting drafts.
50
- - If repo binding is still unclear, hand off to `repo-binding-closure` before finalizing execution metadata.
51
- - If kickoff cannot proceed, leave an explicit blocker tied to the missing field instead of implying execution already started.
@@ -1,4 +0,0 @@
1
- interface:
2
- display_name: "execution-context-recovery"
3
- short_description: "Recover or repair execution_context before runtime kickoff"
4
- default_prompt: "Use execution-context-recovery when CLAPS has the task and repo binding, but the execution lane still needs a stable branch, worktree, runtime, or prepared execution context before kickoff."
@@ -1,41 +0,0 @@
1
- ---
2
- name: git-delivery
3
- description: >
4
- Use this skill when CLAPS execution has produced repo changes that should be
5
- staged, committed, pushed, and handed off with branch, commit, and review
6
- evidence.
7
- ---
8
-
9
- # git-delivery
10
-
11
- Use this skill when implementation is done and the remaining work is shipping evidence, not more coding.
12
-
13
- ## Goals
14
-
15
- - Turn validated repo changes into a clean delivery artifact.
16
- - Avoid vague “done” claims by leaving commit, branch, and review context behind.
17
- - Stop cleanly when there is nothing worth committing.
18
-
19
- ## Flow
20
-
21
- 1. Review the diff
22
- Check what actually changed and confirm it matches the task scope and acceptance criteria.
23
-
24
- 2. Stage and commit
25
- Stage the intended files, create a concise commit message, and record the resulting commit SHA.
26
-
27
- 3. Push the branch
28
- Push the task branch to the configured remote. Treat auth failures or remote errors as explicit blockers.
29
-
30
- 4. Open the review handoff
31
- When the provider path supports it, create the merge request or review link and include it in the task handoff.
32
-
33
- 5. Deliver with evidence
34
- Report what changed, how it was validated, which branch and commit contain the work, and what still needs human review.
35
-
36
- ## Guidance
37
-
38
- - If `git status` is clean after staging, say there was no shippable diff instead of forcing an empty commit.
39
- - Prefer one coherent delivery summary over a long changelog.
40
- - Keep review evidence attached to the task or conversation so humans can verify the outcome quickly.
41
- - If push or MR creation is unavailable, still hand off the exact branch and commit context.
@@ -1,4 +0,0 @@
1
- interface:
2
- display_name: "git-delivery"
3
- short_description: "Stage, commit, push, and hand off repo changes with review evidence"
4
- default_prompt: "Use git-delivery when CLAPS work is ready to be staged, committed, pushed, and handed off with concise branch plus validation evidence."