@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.
- package/index.js +12085 -9067
- package/package.json +1 -2
- package/skills/assignment-kickoff-orchestration/SKILL.md +0 -53
- package/skills/assignment-kickoff-orchestration/agents/openai.yaml +0 -4
- package/skills/assignment-kickoff-orchestration/references/kickoff-checklist.md +0 -23
- package/skills/chat-task-delivery/SKILL.md +0 -33
- package/skills/chat-task-delivery/agents/openai.yaml +0 -4
- package/skills/claps-cli/SKILL.md +0 -203
- package/skills/claps-cli/agents/openai.yaml +0 -4
- package/skills/claps-cli/references/capabilities.md +0 -96
- package/skills/execution-context-recovery/SKILL.md +0 -51
- package/skills/execution-context-recovery/agents/openai.yaml +0 -4
- package/skills/git-delivery/SKILL.md +0 -41
- package/skills/git-delivery/agents/openai.yaml +0 -4
- package/skills/manifest.json +0 -324
- package/skills/merge-closeout/SKILL.md +0 -46
- package/skills/merge-closeout/agents/openai.yaml +0 -4
- package/skills/planning-baseline/SKILL.md +0 -43
- package/skills/planning-baseline/agents/openai.yaml +0 -4
- package/skills/planning-baseline/references/state-examples.md +0 -75
- package/skills/planning-session-convergence/SKILL.md +0 -50
- package/skills/planning-session-convergence/agents/openai.yaml +0 -4
- package/skills/preview-gateway/SKILL.md +0 -58
- package/skills/preview-gateway/agents/openai.yaml +0 -4
- package/skills/project-admin/SKILL.md +0 -44
- package/skills/project-admin/agents/openai.yaml +0 -4
- package/skills/repo-binding-closure/SKILL.md +0 -54
- package/skills/repo-binding-closure/agents/openai.yaml +0 -4
- package/skills/repo-binding-closure/references/execution-lane-checklist.md +0 -27
- package/skills/review-handoff/SKILL.md +0 -40
- package/skills/review-handoff/agents/openai.yaml +0 -4
- package/skills/roadmap.json +0 -127
- package/skills/task-admin/SKILL.md +0 -59
- package/skills/task-admin/agents/openai.yaml +0 -4
- package/skills/task-contract-draft/SKILL.md +0 -80
- package/skills/task-contract-draft/agents/openai.yaml +0 -4
- package/skills/task-detail-lookup/SKILL.md +0 -51
- package/skills/task-detail-lookup/agents/openai.yaml +0 -4
- package/skills/task-pool-triage/SKILL.md +0 -56
- package/skills/task-pool-triage/agents/openai.yaml +0 -4
- package/skills/task-stage-summary-backfill/SKILL.md +0 -75
- package/skills/task-stage-summary-backfill/agents/openai.yaml +0 -4
- package/skills/user-story-delivery/SKILL.md +0 -76
- package/skills/user-story-delivery/agents/openai.yaml +0 -4
- package/skills/workspace-bootstrap/SKILL.md +0 -41
- package/skills/workspace-bootstrap/agents/openai.yaml +0 -4
package/package.json
CHANGED
|
@@ -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."
|