aligndev 0.28.1 → 0.29.0
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/README.md +13 -5
- package/dist/alignfirst-cli.js +21 -8
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +16 -4
- package/dist/code/claude-agent.js +1 -1
- package/dist/code/code-cli.js +2 -4
- package/dist/code/codex-agent.js +1 -1
- package/dist/code/machine-id.js +14 -3
- package/dist/code/pi-agent.js +1 -1
- package/dist/code/run-agent.js +37 -1
- package/dist/command-form.d.ts +5 -2
- package/dist/command-form.js +15 -6
- package/dist/guide/code-guide.d.ts +2 -2
- package/dist/guide/code-guide.js +4 -8
- package/dist/guide/guide-cli.js +84 -29
- package/dist/guide/render-template.d.ts +4 -0
- package/dist/guide/render-template.js +51 -12
- package/dist/guide/topics.d.ts +8 -3
- package/dist/guide/topics.js +26 -7
- package/dist/project/plans.js +1 -1
- package/dist/worktree/add.d.ts +3 -13
- package/dist/worktree/add.js +7 -101
- package/dist/worktree/setup.d.ts +18 -0
- package/dist/worktree/setup.js +192 -0
- package/dist/worktree/worktree-cli.js +29 -11
- package/package.json +4 -1
- package/templates/guide/code.md +12 -3
- package/templates/guide/playbook/channel-handling.md +12 -17
- package/templates/guide/playbook/consultation.md +24 -17
- package/templates/guide/playbook/dispatcher.md +18 -0
- package/templates/guide/playbook/{discord-message-tool.md → message-tool.md} +29 -0
- package/templates/guide/playbook/playbook.md +53 -20
- package/templates/guide/playbook/project-lifecycle.md +26 -11
- package/templates/guide/playbook/project-workspace-setup.md +87 -62
- package/templates/guide/playbook/work-files-setup.md +1 -1
- package/templates/guide/playbook/working-session.md +195 -112
- package/templates/guide/playbook/slack-message-tool.md +0 -23
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# Runbook: Project workspace setup
|
|
2
2
|
|
|
3
|
-
{{#
|
|
3
|
+
{{#thread}}
|
|
4
4
|
The setup phase of a working session: get the workspace ready before handling the user's request. You're in a thread session, so your plain-text replies are your delivery — but only the message that **ends your turn** is guaranteed to post; mid-turn lines may never leave the transcript. The message you end the setup turn with must carry everything the user needs: the `[WORKSPACE]` banner (Step 4) and what you did or launched. Never call `message` `send`/`thread-reply` targeting your own thread: it posts everything twice.
|
|
5
|
-
{{/
|
|
6
|
-
{{#
|
|
5
|
+
{{/thread}}
|
|
6
|
+
{{#conversation}}
|
|
7
7
|
The setup phase of a working session: decide the workplace and get it ready before handling the user's request. The message you end the setup turn with carries the `[WORKSPACE]` banner (Step 4) and what you did or launched, or the question Step 2 or Step 5 asks the user.
|
|
8
|
-
{{/
|
|
8
|
+
{{/conversation}}
|
|
9
9
|
|
|
10
10
|
{{#openclaw}}
|
|
11
11
|
## Prerequisites — run both now, before Step 1
|
|
@@ -15,17 +15,17 @@ The setup phase of a working session: decide the workplace and get it ready befo
|
|
|
15
15
|
{{/codingAgent}}
|
|
16
16
|
|
|
17
17
|
{{#openclaw}}
|
|
18
|
-
- `{{
|
|
18
|
+
- `{{GUIDE}} code` (`exec`) — the delegation manual. Required every time you run this procedure, status requests included; do not skip it because no coding seems planned.
|
|
19
19
|
{{/openclaw}}
|
|
20
20
|
{{#codingAgent}}
|
|
21
|
-
- `{{
|
|
21
|
+
- `{{GUIDE}} code` — the delegation manual. Required every time you run this procedure, status requests included; do not skip it because no coding seems planned.
|
|
22
22
|
{{/codingAgent}}
|
|
23
23
|
{{#openclaw}}
|
|
24
24
|
- run `{{ALIGNDEV}} project status <PROJECT_PATH>` and retain its `DEVELOPERS.md` path as DEVELOPERS_PATH, then read that file when it exists — how to create a worktree or a branch.
|
|
25
25
|
{{/openclaw}}
|
|
26
26
|
{{#codingAgent}}
|
|
27
27
|
{{#hasGuide}}
|
|
28
|
-
- Read DEVELOPERS_PATH, retained by Step 1 of `{{
|
|
28
|
+
- Read DEVELOPERS_PATH, retained by Step 1 of `{{GUIDE}} working-session` — whether the project has workspace tooling, and how to create a worktree or a branch.
|
|
29
29
|
{{/hasGuide}}
|
|
30
30
|
{{/codingAgent}}
|
|
31
31
|
|
|
@@ -34,74 +34,90 @@ The setup phase of a working session: decide the workplace and get it ready befo
|
|
|
34
34
|
You need:
|
|
35
35
|
|
|
36
36
|
- **PROJECT** — The main-worktree directory name shown to the user.
|
|
37
|
-
{{#
|
|
37
|
+
{{#thread}}
|
|
38
38
|
- **PROJECT_PATH** — The canonical absolute main-worktree path recorded in the thread starter.
|
|
39
|
-
{{/
|
|
40
|
-
{{#
|
|
41
|
-
- **PROJECT_PATH** — The canonical absolute main-worktree path resolved by Step 1 of `{{
|
|
39
|
+
{{/thread}}
|
|
40
|
+
{{#conversation}}
|
|
41
|
+
- **PROJECT_PATH** — The canonical absolute main-worktree path resolved by Step 1 of `{{GUIDE}} working-session`.
|
|
42
42
|
- **The workplace and the default branch** — The session's worktree, its branch, and the project's default branch, retained by the same step.
|
|
43
|
-
{{/
|
|
43
|
+
{{/conversation}}
|
|
44
44
|
- **TICKET_ID** — The external ticket ID or the side ticket `side-N` reserved by the working session.
|
|
45
45
|
|
|
46
46
|
If PROJECT, PROJECT_PATH, or TICKET_ID is missing, do not proceed. Do not guess or reconstruct these values. Ask the user.
|
|
47
47
|
|
|
48
|
-
{{#
|
|
48
|
+
{{#thread}}
|
|
49
49
|
## Step 2 — Post the setup signal
|
|
50
50
|
|
|
51
51
|
Setting up a workspace takes a while, so tell the user it started before you start it. One short line, in their language, and nothing else — the thread's starter already states the known project, ticket and task, so restating them here just repeats a message they can see.
|
|
52
|
-
{{/
|
|
53
|
-
{{#
|
|
52
|
+
{{/thread}}
|
|
53
|
+
{{#conversation}}
|
|
54
54
|
## Step 2 — Decide the workplace
|
|
55
55
|
|
|
56
56
|
The workplace is the first case that matches:
|
|
57
57
|
|
|
58
|
-
1. **The user's request or instructions name the place** — a directory, a branch, a workspace: work there. For a directory, post its banner and go to Step 5. For a branch, Step 4 finds or attaches that branch rather than choosing another ticket branch.
|
|
59
|
-
2. **The session's branch carries TICKET_ID** — work in place. Skip
|
|
60
|
-
3. **The session's
|
|
61
|
-
|
|
58
|
+
1. **The user's request or instructions name the place** — a directory, a branch, a workspace: work there. For a directory, apply Step 4's existing-workplace preparation, post its banner and go to Step 5. For a branch, Step 4 finds or attaches that branch rather than choosing another ticket branch.
|
|
59
|
+
2. **The session's branch carries TICKET_ID** — work in place. Skip the setup signal and branch selection: apply Step 4's existing-workplace preparation, post the `[WORKSPACE]` banner with the session's worktree and branch, then go to Step 5.
|
|
60
|
+
3. **The session's worktree is a fresh harness worktree** — a linked worktree (its `git rev-parse --git-common-dir` is not its own `.git`) with a clean tree, on a branch that carries no ticket ID or on a detached HEAD, with no commit beyond the default branch: after `git fetch`, `git rev-list --count origin/<default>..HEAD` is `0`. OpenClaw (branch `openclaw/<name>`), Claude Code, Codex and Paseo create such worktrees. Work in place on the ticket branch, without asking. First run Step 4's two checks for TICKET_ID. A status request never creates a branch: with no ticket branch, it ends as sub-path 3 of Step 4 does. Otherwise:
|
|
61
|
+
- The ticket branch has a registered workspace: use that workspace, as sub-path 1 of Step 4. The fresh worktree stays unused.
|
|
62
|
+
- The ticket branch exists without a workspace: run `git switch <branch>` in the session's worktree.
|
|
63
|
+
- No ticket branch: run `git switch -c {TICKET_ID}/{1-3-words} origin/<default>` in the session's worktree.
|
|
64
|
+
|
|
65
|
+
After a switch, skip the setup signal: apply Step 4's existing-workplace preparation, post the `[WORKSPACE]` banner with the session's worktree and its new branch, then go to Step 5.
|
|
66
|
+
4. **The session's branch is long-lived, or there is no session workplace** — the default branch, a name such as `main`, `master`, `develop`, `release` or `production`, or a conversation that started outside the project: open or create the ticket's workspace in Step 4, without asking.
|
|
67
|
+
5. **Any other branch**, one carrying another ticket's ID included — end the turn on one message asking where to work. On the answer, "here" means the session's worktree as it is, handled as in case 2; a branch or a directory the user names falls under case 1.
|
|
68
|
+
|
|
69
|
+
**Registration in place.** Working in place (cases 2 and 3, and "here" in case 5) in a linked worktree that the project's tooling does not list starts with its registration, run in the foreground before the `[WORKSPACE]` banner. With workspace tooling, run its documented adoption command in that worktree: `workspace setup` without a branch for the AlignFirst workspace system, after the project's install when its wrapper needs one. Without tooling, run `{{ALIGNDEV}} worktree setup --json` in that worktree: it shares the work files and reports readiness for Git and work files only. Neither runs on the main worktree. The banner reports the state the registration returns.
|
|
70
|
+
{{#app}}
|
|
71
|
+
|
|
72
|
+
**An OpenClaw managed worktree.** A conversation created with a worktree runs in a checkout on branch `openclaw/<name>`, adopted by case 3. Switching it to the ticket branch takes it off `openclaw/<name>`, so OpenClaw retains it and never removes it, even when the conversation is archived or idle. From then on, the workspace rules apply to it like any other workspace, teardown and post-merge removal included. After `workspace remove` or `{{ALIGNDEV}} worktree remove` deletes it, OpenClaw marks its record removed.
|
|
73
|
+
{{/app}}
|
|
62
74
|
|
|
63
75
|
## Step 3 — Post the setup signal
|
|
64
76
|
|
|
65
77
|
Post the signal only when Step 2 opens or creates a workspace.
|
|
66
78
|
|
|
67
79
|
Setting up a workspace takes a while, so tell the user it started before you start it. One short line, in their language, and nothing else — the user already knows the project, ticket and task, so restating them here just repeats what they have seen.
|
|
68
|
-
{{/
|
|
80
|
+
{{/conversation}}
|
|
69
81
|
|
|
70
82
|
Vary the wording: "Je prépare le workspace", "Setting up the workspace", "Spinning up the environment", "Getting the worktree ready", "Preparing the branch". No questions, no waiting.
|
|
71
83
|
|
|
72
|
-
{{#
|
|
84
|
+
{{#thread}}
|
|
73
85
|
On some surfaces this line never posts (mid-turn text — see the delivery note at the top). Write it anyway, and count on the end-of-turn message, not on it, for anything the user must see.
|
|
74
|
-
{{/
|
|
86
|
+
{{/thread}}
|
|
75
87
|
|
|
76
|
-
{{#
|
|
88
|
+
{{#thread}}
|
|
77
89
|
When the task changed with the message that woke you — a ticket that just arrived in a conversation thread, a scope the user just corrected — add a one-line restatement of what you're now working on. That line is the thread's durable record of the new task, the way the starter was for the original one.
|
|
78
|
-
{{/
|
|
79
|
-
{{#
|
|
90
|
+
{{/thread}}
|
|
91
|
+
{{#conversation}}
|
|
80
92
|
When the task changed with the user's latest message — a ticket that just arrived, a scope the user just corrected — add a one-line restatement of what you're now working on. That line is the conversation's record of the new task.
|
|
81
|
-
{{/
|
|
93
|
+
{{/conversation}}
|
|
82
94
|
|
|
83
|
-
{{#
|
|
95
|
+
{{#thread}}
|
|
84
96
|
## Step 3 — Name the thread (Discord-only)
|
|
85
97
|
|
|
98
|
+
{{#discord}}
|
|
86
99
|
Rename the thread whenever its name doesn't match what you now know. Format: `<TICKET_ID> - <PROJECT> - <1-to-5-word description>`, the description covering the task. A ticket that just arrived, a project that was unknown when the thread opened, a task that turned out to be something else — each one calls for the rename.
|
|
87
100
|
|
|
88
101
|
Discord renames a thread through a post, so make the setup signal carry it: send that line with `message` `action: "send"`, passing the current thread's complete `chat_id` as `target`, the new name as `threadName`, and the line itself as `message`. Don't also write the line as plain text; that posts it twice. The post does not end the turn: Step 4 follows in the same turn, and the turn ends on the banner.
|
|
89
102
|
|
|
90
103
|
That single call is the whole exception. The post right after it, and every one that follows, is plain text again; with nothing to rename, the tool never targets your own thread.
|
|
91
|
-
{{/
|
|
104
|
+
{{/discord}}
|
|
105
|
+
{{/thread}}
|
|
92
106
|
|
|
93
|
-
{{#
|
|
107
|
+
{{#thread}}
|
|
94
108
|
## Step 4 — Set up the project workspace (worktree and branch)
|
|
95
|
-
{{/
|
|
96
|
-
{{#
|
|
109
|
+
{{/thread}}
|
|
110
|
+
{{#conversation}}
|
|
97
111
|
## Step 4 — Set up the workspace (worktree and branch)
|
|
98
|
-
{{/
|
|
112
|
+
{{/conversation}}
|
|
99
113
|
|
|
100
|
-
{{#
|
|
101
|
-
When the user named a directory, or a recorded workplace's branch already carries TICKET_ID,
|
|
102
|
-
{{/
|
|
114
|
+
{{#thread}}
|
|
115
|
+
When the user named a directory, or a recorded workplace's branch already carries TICKET_ID, retain that workplace: apply the existing-workplace preparation below, post its banner and go to Step 5. When the user named a branch, find or attach it below rather than choosing another ticket branch.
|
|
116
|
+
{{/thread}}
|
|
103
117
|
|
|
104
|
-
The project has workspace tooling when its developer guide documents one, whatever the implementation. Use it when present; otherwise use `{{ALIGNDEV}} worktree list/add/remove`. Never bypass it with raw `git worktree add`/`remove`/`prune` or directory deletion.
|
|
118
|
+
The project has workspace tooling when its developer guide documents one, whatever the implementation. Use it when present; otherwise use `{{ALIGNDEV}} worktree list/add/setup/remove`. Never bypass it with raw `git worktree add`/`remove`/`prune` or directory deletion. An external tool owning Git creation and deletion is a separate case; adopt its selected worktree through the applicable setup tooling.
|
|
119
|
+
|
|
120
|
+
**Existing-workplace preparation:** follow the project's documented readiness/setup procedure when it has tooling. Otherwise run `{{ALIGNDEV}} worktree setup <exact-worktree-root> --json` yourself before reporting readiness or delegating. Registration alone does not prove readiness, including for externally created worktrees. Setup keeps the selected path and branch without creating or switching branches. Without a path, it discovers the current root even from nested cwd; an explicit path resolves relative to the caller and must name an exact registered root of the same repository. Conflicts remain untouched. Repair the reported problem and retry the idempotent setup to complete partial preparation. Relay failures and delete nothing; plans provisioning or migration requires the separate authorization in `{{GUIDE}} work-files-setup`.
|
|
105
121
|
|
|
106
122
|
First, select the base ref from the project or user instructions, otherwise use the base branch's configured upstream. Use the local base ref when the repository has no remote; ask when the choice is unclear. Fetch its remote from PROJECT_PATH with `git fetch --prune <remote>` when applicable, and retain the selected base ref for creation and synchronization. Then check what already exists for the explicitly selected branch, or otherwise for {TICKET_ID} — two checks, both required:
|
|
107
123
|
|
|
@@ -112,27 +128,36 @@ Never assume the branch is new; `git worktree list` alone does not answer the br
|
|
|
112
128
|
|
|
113
129
|
Whenever a branch exists, you work from its workspace — a status request included. "Status" means: set up the workspace, report its state (the banner below), sync the branch (Step 5), then report the work content (Step 6) — never `git log` from the main dir. Pick one sub-path:
|
|
114
130
|
|
|
115
|
-
1. **Branch + workspace already registered** →
|
|
131
|
+
1. **Branch + workspace already registered** → retain it and apply existing-workplace preparation above.
|
|
116
132
|
2. **Branch exists (local or remote), no workspace** → set up a workspace on the existing branch (don't create a new branch).
|
|
117
133
|
3. **No branch** → for a status request, end the turn on a message reporting that no workspace or code work exists, with any request, spec, and summary files listed by the ticket preflight; create nothing. Any other request is new-work intent: name a new branch `{TICKET_ID}/{1-3-words}`, deriving the short description from the request. Start it from the selected base ref. Creating from that ref requires no checkout or clean main worktree.
|
|
118
134
|
|
|
119
135
|
With workspace tooling, delegate the setup through its documented commands. Without it, run `{{ALIGNDEV}} worktree add` yourself, before any coding delegation, on an absolute sibling path derived from PROJECT and the branch (branch slashes become dashes): `{{ALIGNDEV}} worktree add <path> <existing-branch> --json` for sub-path 2, `{{ALIGNDEV}} worktree add <path> -b <new-branch> <explicit-base-ref> --json` for sub-path 3.
|
|
120
136
|
|
|
121
|
-
The command refuses an occupied path, a dangling symlink included, a branch checked out elsewhere, an ambiguous remote branch, and missing or project-tracked plans. Relay the refusal instead of working around it: reuse the path it reports for an occupied branch, ask the user about an ambiguous remote, run `{{
|
|
137
|
+
The command refuses an occupied path, a dangling symlink included, a branch checked out elsewhere, an ambiguous remote branch, and missing or project-tracked plans. Relay the refusal instead of working around it: reuse the path it reports for an occupied branch, ask the user about an ambiguous remote, run `{{GUIDE}} work-files-setup` for plans and retry; never force a second checkout or invent another path. It returns once the worktree and its work files are ready. Report its warnings, such as a tracked `.local` that stays branch-local, and on a late failure relay its recovery instructions and delete nothing.
|
|
122
138
|
|
|
123
|
-
{{#
|
|
139
|
+
{{#thread}}
|
|
140
|
+
{{#slack}}
|
|
141
|
+
The moment you have the linked workspace path — attached (sub-path 1) or freshly set up (2, 3) — post the `[WORKSPACE]` banner, before any `git` inspection or prose, and **include it again in the message you end the turn with**: the early post may not deliver on every surface, the final message always does. Run the selected setup command in the foreground (no `background` option) and report the state it returns. Run subsequent Git commands and `{{ALIGNDEV}} code` from that linked workspace, never PROJECT_PATH, unless the user explicitly chose in-place work.
|
|
142
|
+
{{/slack}}
|
|
143
|
+
{{#discord}}
|
|
124
144
|
The moment you have the linked workspace path — attached (sub-path 1) or freshly set up (2, 3) — post the `[WORKSPACE]` banner, before any `git` inspection or prose, and **include it again in the message you end the turn with**: the early post may not deliver on every surface, the final message always does (on Discord the Step 3 rename post also delivers). Run the selected setup command in the foreground (no `background` option) and report the state it returns. Run subsequent Git commands and `{{ALIGNDEV}} code` from that linked workspace, never PROJECT_PATH, unless the user explicitly chose in-place work.
|
|
125
|
-
{{/
|
|
126
|
-
{{
|
|
145
|
+
{{/discord}}
|
|
146
|
+
{{/thread}}
|
|
147
|
+
{{#conversation}}
|
|
127
148
|
The moment you have the workplace — in place, attached (sub-path 1) or freshly set up (2, 3) — post the `[WORKSPACE]` banner, before any `git` inspection or prose. Run the selected setup command in the foreground and report the state it returns. Run subsequent Git commands and `{{ALIGNDEV}} code` from the workplace.
|
|
128
|
-
{{/
|
|
149
|
+
{{/conversation}}
|
|
150
|
+
{{#app}}
|
|
129
151
|
|
|
130
|
-
|
|
152
|
+
End the setup turn on a message that carries the banner: text written earlier in the turn may never reach the user.
|
|
153
|
+
{{/app}}
|
|
154
|
+
|
|
155
|
+
{{#thread}}
|
|
131
156
|
Bold the values with your surface's markers rather than literal `**`, and translate the labels to the user's language:
|
|
132
|
-
{{/
|
|
133
|
-
{{#
|
|
157
|
+
{{/thread}}
|
|
158
|
+
{{#conversation}}
|
|
134
159
|
Bold the values in Markdown, and translate the labels to the user's language:
|
|
135
|
-
{{/
|
|
160
|
+
{{/conversation}}
|
|
136
161
|
|
|
137
162
|
```text
|
|
138
163
|
[WORKSPACE] **{PROJECT}** — Ticket: `{TICKET_ID}`
|
|
@@ -142,18 +167,18 @@ Branch: `{branch}`
|
|
|
142
167
|
Status: {running | ready | failed}
|
|
143
168
|
```
|
|
144
169
|
|
|
145
|
-
The lines below the tag report the workspace: after `Status:`, add what the setup output gives that the user can act on. For a worktree
|
|
170
|
+
The lines below the tag report the workspace: after `Status:`, add what the setup output gives that the user can act on. For a worktree prepared by `{{ALIGNDEV}} worktree add` or `setup`, say that `ready` covers the worktree and work files only, and delegate the repository's documented install/build/test preparation separately before coding needs it.
|
|
146
171
|
|
|
147
|
-
{{#
|
|
172
|
+
{{#thread}}
|
|
148
173
|
## Step 5 — Sync an existing branch on takeover (sub-paths 1 & 2)
|
|
149
|
-
{{/
|
|
150
|
-
{{#
|
|
174
|
+
{{/thread}}
|
|
175
|
+
{{#conversation}}
|
|
151
176
|
## Step 5 — Sync an existing branch
|
|
152
|
-
{{/
|
|
177
|
+
{{/conversation}}
|
|
153
178
|
|
|
154
|
-
{{#
|
|
179
|
+
{{#conversation}}
|
|
155
180
|
In place on an existing branch, fetch first. A fast-forward of the branch onto its remote counterpart or onto the base branch, on a clean tree, is the only sync done without asking: do it, then report it in one line. Anything else — uncommitted changes, a remote branch that does not fast-forward, a base-branch catch-up that needs a merge commit — ends the turn on one message stating what will happen ("I'll commit your changes as WIP and merge `main`, OK?"). The list below runs on the user's yes. In a workspace you opened or created, the list runs directly.
|
|
156
|
-
{{/
|
|
181
|
+
{{/conversation}}
|
|
157
182
|
|
|
158
183
|
Skip on sub-path 3 (no branch — nothing to sync). If Step 4 was skipped, select and fetch the base ref as described there. Once the workspace is set up, bring the branch up to date *before* inspecting, working, or reporting a status — a teammate may have pushed since you last synced, and a report off a stale branch is wrong. In order:
|
|
159
184
|
|
|
@@ -174,21 +199,21 @@ The `[WORKSPACE]` banner answers "is the env ready", not "where does the work st
|
|
|
174
199
|
- **Repo/workflow metadata**, which you may gather directly: `git log`/`status`/branch state, `gh` PR/issue state, the `.plans/` listing.
|
|
175
200
|
- **The ticket's AlignFirst artifacts** via `{{ALIGNDEV}} code new --ticket <id> --catchup`, run from the worktree: the agent loads the ticket history and returns a synthesis.
|
|
176
201
|
|
|
177
|
-
{{#
|
|
202
|
+
{{#thread}}
|
|
178
203
|
Combine them into the report and post it in the thread; use `--catchup` whenever the ticket history matters. Add `--protocol aad` or `--protocol spec` to continue with that protocol in the same `{{ALIGNDEV}} code` call. What you must **not** do is browse the source to describe how the code works — that's a delegation to the agent, not part of a status report.
|
|
179
|
-
{{/
|
|
180
|
-
{{#
|
|
204
|
+
{{/thread}}
|
|
205
|
+
{{#conversation}}
|
|
181
206
|
Combine them into the report and post it in the conversation; use `--catchup` whenever the ticket history matters. Add `--protocol aad` or `--protocol spec` to continue with that protocol in the same `{{ALIGNDEV}} code` call. What you must **not** do is browse the source to describe how the code works — that's a delegation to the agent, not part of a status report.
|
|
182
|
-
{{/
|
|
207
|
+
{{/conversation}}
|
|
183
208
|
|
|
184
209
|
## Step 7 — Start the work
|
|
185
210
|
|
|
186
|
-
{{#
|
|
187
|
-
The workspace is ready. Before a coding delegation, apply the takeover-turn race checkpoint in the playbook (`{{
|
|
188
|
-
{{/
|
|
189
|
-
{{#
|
|
211
|
+
{{#thread}}
|
|
212
|
+
The workspace is ready. Before a coding delegation, apply the takeover-turn race checkpoint in the playbook (`{{GUIDE}}`). Then announce what you're about to do in one line and do it. The user's request is the go-ahead; asking them to confirm it again wastes a turn.
|
|
213
|
+
{{/thread}}
|
|
214
|
+
{{#conversation}}
|
|
190
215
|
The workspace is ready. Announce what you're about to do in one line and do it. The user's request is the go-ahead; asking them to confirm it again wastes a turn.
|
|
191
|
-
{{/
|
|
216
|
+
{{/conversation}}
|
|
192
217
|
|
|
193
218
|
{{#openclaw}}
|
|
194
219
|
When the work is an `{{ALIGNDEV}} code` run, launch it as the delegation guide describes: background `exec` with `timeoutSeconds: 0`, then end the turn on the acknowledgement. Call nothing on the `{{ALIGNDEV}} code` session before the chained turn wakes you, whatever the `exec` acknowledgement suggests.
|
|
@@ -8,7 +8,7 @@ For explicit companion-only onboarding, start at section 3 under the onboarding
|
|
|
8
8
|
|
|
9
9
|
Run `{{ALIGNFIRST}} plans check --json` from PROJECT_PATH. It reads the effective `.plans` location from `{{ALIGNFIRST}} config --json`, where explicit `project` or `companion` selections win and, under `auto`, an existing companion copy wins over an existing project copy; when neither exists, a registered companion is the creation target. The check passes when that location is a usable directory with no file tracked by this project's own repository, through a tracked symlink, mixed tracked/untracked contents, or an alias into tracked files included. A separate work-files repository may track its contents, and an unused tracked project `.plans` is not a blocker when a usable companion is effective.
|
|
10
10
|
|
|
11
|
-
If `--json` is rejected, the selected AlignFirst CLI needs upgrading alongside AlignDev.
|
|
11
|
+
If `--json` is rejected, the selected AlignFirst CLI needs upgrading alongside AlignDev. Check the AlignFirst installation selected by `{{ALIGNFIRST}}`. For npm/npx, check the project's local `alignfirst` dependency first. Retry the JSON check after upgrading; do not substitute a plain-text check.
|
|
12
12
|
|
|
13
13
|
When an existing linked worktree is selected, run the command there too: it also requires the same effective target as the main worktree. A different location is an error: do not create a second history or repair links silently.
|
|
14
14
|
|