@windyroad/itil 3.4.0-preview.1369 → 3.4.0-preview.1371
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/package.json
CHANGED
|
@@ -16,7 +16,7 @@ Read the relevant current evidence, project instructions, decisions, jobs, risk
|
|
|
16
16
|
|
|
17
17
|
Use SMART to make the objective specific, measurable through observable completion evidence, achievable against known constraints, relevant to the user's job, and time-bound using the user's stated deadline or timeframe. Qualitative evidence can establish success. Surface feasibility uncertainty instead of weakening the objective or promising certainty. Never invent numerical targets or dates. Preserve stated timing and prefer relative wording. Any added date must match verified context and its weekday. Never turn a guessed date into a new timing interview. If neither a time bound nor an explicit decision to omit one is established, ask one timing question and wait. If the user declines a time bound, record the exception honestly rather than claiming full SMART compliance.
|
|
18
18
|
|
|
19
|
-
If
|
|
19
|
+
If outcome information is unclear or missing, interview the user: **ask one focused question, then stop and wait for their answer before asking the next**. Select the next question from their actual answer and remaining uncertainty. Do not bundle questions, answer on their behalf, invent their intent, or resolve ambiguity by selecting a solution. Bounded read-only investigation can establish facts within existing authority.
|
|
20
20
|
|
|
21
21
|
One question requests **one missing fact**. Do not combine multiple information needs, such as who benefits and what is wrong, into a multipart question. Sharing a topic or using one question mark does not make it one question.
|
|
22
22
|
|
|
@@ -104,6 +104,6 @@ Finish when the objective's completion evidence is satisfied. Record the verifie
|
|
|
104
104
|
|
|
105
105
|
Recording verified completion is a terminal status update, not another executable plan. Any newly proposed work still needs its own assessed plan.
|
|
106
106
|
|
|
107
|
-
|
|
107
|
+
Before handing back a blocker, finish useful authorized work, including running checks. Preserve work, distinguish completed increments from unfinished outcomes, and report the precise missing result, capability, authority or irreducible user action. Resume from fresh evidence when the blocker clears; do not restart completed effects.
|
|
108
108
|
|
|
109
109
|
Communicate the objective, consequential plan changes, decisions requiring input, exact blockers, and verified outcomes concisely. Avoid narrating routine commands or every review and wait.
|
|
@@ -128,21 +128,62 @@ Give the existing planning critic the saved outcome and affected increment recor
|
|
|
128
128
|
|
|
129
129
|
**Horizon belongs only to increments**: each planned or active increment has exactly one of Now, Next or Later. Remove completed or superseded increments from active horizons while preserving their prior position in history. **Status** separately describes execution, such as ready, in progress, blocked or done. A blocked Now increment does not automatically become Next; a completed task does not become a completed outcome. Outcomes and tasks do not inherit Horizon. Map these meanings to existing repository labels or Project fields. Replace the previous horizon when replanning rather than accumulating contradictory values.
|
|
130
130
|
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
131
|
+
Maintain parent/child and prerequisite relationships in this order:
|
|
132
|
+
|
|
133
|
+
1. Inspect the actual relationship and the precise result that unlocks a start,
|
|
134
|
+
stage or completion. Read current native sub-issue and blocked-by state when
|
|
135
|
+
supported. A native write denial proves neither presence nor absence:
|
|
136
|
+
preserve known links and keep unreadable native state unknown.
|
|
137
|
+
2. Keep completion dependencies acyclic. A prerequisite cannot require its
|
|
138
|
+
dependent's result to close. Propose changed task boundaries and acceptance
|
|
139
|
+
in the increment thread; the increment owner records agreement with affected
|
|
140
|
+
task owners before applying them. Obtain the five independent reviews before
|
|
141
|
+
materially revised execution. Give each task an independently verifiable
|
|
142
|
+
result and retain the combined results in increment acceptance.
|
|
143
|
+
3. After any required agreement and reviews, use native links when supported;
|
|
144
|
+
create a missing required link or update a changed one when authorized.
|
|
145
|
+
Verify saved native state and both relationship directions. If operations are
|
|
146
|
+
unavailable, record their exact limitation plus reciprocal parent/child or
|
|
147
|
+
prerequisite/dependent text links on both affected issues; text is not proof
|
|
148
|
+
of native state. Request capable help through an authorized channel when
|
|
149
|
+
useful, without inventing a helper or widening access.
|
|
150
|
+
4. Reassess actual useful work and status under the claim table below. A Ready
|
|
151
|
+
or In progress task may prepare while a real prerequisite remains open;
|
|
152
|
+
preserve its precise unlock condition and required evidence. Independently
|
|
153
|
+
verify the prerequisite result before clearing that condition and proceeding
|
|
154
|
+
with the dependent stage. Administrative issue closure is not another
|
|
155
|
+
prerequisite unless recorded acceptance or a project rule requires it.
|
|
156
|
+
|
|
157
|
+
Optional Project membership and fields mirror issue state; do not create them
|
|
158
|
+
merely because this protocol mentions them.
|
|
159
|
+
|
|
160
|
+
Replan task boundaries at any stage when evidence changes what work is needed. Coordinate narrowed, split, replaced or dropped scope with the increment owner and affected task owners. Close redundant or superseded issues as **not planned**, with the reason and successor links; never mark undelivered work Done merely to retire it. Before removing a dependency, move still-required acceptance evidence to the appropriate task and retain it in increment acceptance. Remove only genuinely obsolete native dependencies and verify the saved result; preserve prerequisites that still constrain the revised work. Keep task briefs, links, ownership and selected Project fields truthful. Preserve retired tasks' Agent attribution and saved history; update only fields needed to reflect their retirement. Never blanket-clear a closed task's Project fields. Clear an active Horizon only for completed or superseded increments. Routine task reconciliation within the assessed outcome and authority needs no new user approval; materially revised executable work still requires the five independent plan reviews.
|
|
161
|
+
|
|
162
|
+
### Status and contribution-claim decision
|
|
163
|
+
|
|
164
|
+
Use this table whenever work starts, blocks, finishes or is handed over. Inspect
|
|
165
|
+
scope, inputs and actual useful authorized in-task steps first: a stored Blocked
|
|
166
|
+
status alone does not establish exhaustion. Genuine assigned watcher duties
|
|
167
|
+
count as useful work; waiting for an unverified response or routine discussion
|
|
168
|
+
reads alone do not retain an exhausted implementation reservation.
|
|
169
|
+
|
|
170
|
+
| Actual state of the claimed task | Status | Assignment and saved result |
|
|
140
171
|
| --- | --- | --- |
|
|
141
|
-
| Recorded acceptance is verified with evidence | Done |
|
|
172
|
+
| Recorded acceptance is verified with evidence | Done | Post acceptance evidence, finish and preserve attribution history. |
|
|
142
173
|
| Useful authorized in-task work remains | In progress | Retain the single claim and do that work. |
|
|
143
|
-
| A required input is unavailable and no useful authorized in-task step remains | Blocked |
|
|
174
|
+
| A required input is unavailable and no useful authorized in-task step remains | Blocked | Save the blocker, evidence, unlock condition and handover; remove your assignment and read back its removal. Preserve historical attribution. |
|
|
175
|
+
|
|
176
|
+
One contribution claim is a ceiling, not a retention requirement. A blocked
|
|
177
|
+
assignment still counts until release is verified. Apply the table before
|
|
178
|
+
claiming another task; never reserve queued tasks. Outcome/increment ownership
|
|
179
|
+
does not reserve contributions. Agents sharing an account remain distinct by
|
|
180
|
+
their recorded agent/session. Keep actionable unclaimed work Ready/Unclaimed;
|
|
181
|
+
a blocked task does not block every contribution. Never invent busywork.
|
|
144
182
|
|
|
145
|
-
|
|
183
|
+
If assignment mutation or verification is unavailable, record the exact pending
|
|
184
|
+
release and known claim state, use an authorized owner/channel when available,
|
|
185
|
+
and do not claim release or take another task while still assigned. Reassess
|
|
186
|
+
when evidence changes.
|
|
146
187
|
|
|
147
188
|
## Join, claim and contribute
|
|
148
189
|
|
|
@@ -151,40 +192,40 @@ Use this contribution lifecycle:
|
|
|
151
192
|
1. Read the outcome, current Now revision, discussion, dependencies and claims. Reconcile stale scope before dependent work.
|
|
152
193
|
2. Choose a bounded useful result and announce its acceptance and file/operation boundary in the increment thread. Resolve overlap, shared operations or authority questions with affected owners. A non-overlapping task within the assessed Now needs no allocator approval.
|
|
153
194
|
3. Reuse a matching unclaimed task, or create your own just before work. Apply the established task-kind marker (`kind:task` by default). Assign it to the **actual authenticated account** and record the **specific agent/session** and native links; read back kind, assignment, claim and links and recheck competing work. For a selected or required Project, explicitly add the task and read back its membership and applicable fields so it matches the saved view.
|
|
154
|
-
4. Execute within the assessed plan and authority
|
|
195
|
+
4. Execute within the assessed plan and authority; apply the status and contribution-claim decision above, including saved release when exhausted.
|
|
155
196
|
5. Choose and document the next useful contribution from the remaining outcome gap, then repeat these checks before claiming it.
|
|
156
197
|
|
|
157
198
|
A starting battle plan exposes likely work, dependencies and parallel opportunities without precreating, assigning or reserving every future task. The increment owner keeps acceptance, sequence and integration clear and resolves overlap/dependencies. Explicit assignments and handoffs remain valid. Two agents sharing an account are distinct contributors. Checklists suffice for routine steps; do not create a task for every command. Task creation within assessed scope requires no fresh human approval.
|
|
158
199
|
|
|
159
|
-
**One contribution claim is a ceiling, not a retention requirement.** A blocked assignment still counts until its release is verified. For an unfinished task, when no useful authorized in-task step remains, hand over the remaining gap, remove your assignment and read back its removal; do not retain it merely because its dependency is unresolved. Preserve genuine assigned watcher duties; routine discussion reads alone do not justify retaining an exhausted reservation. Finish, explicitly hand over or release the current assignment before claiming another. Do not reserve queued tasks. Outcome or increment coordination ownership does not reserve contribution tasks. Agents sharing an account remain distinct through their recorded agent/session identities.
|
|
160
|
-
|
|
161
200
|
Before declaring a contribution ready to start, complete this claim receipt: **no other contribution assignment held; parent increment; current assessed plan revision; non-overlapping scope; dependencies (or explicitly none); actual account; distinct agent/session; saved claim and reciprocal-link readback; competing-claim recheck.** Record all fields on the task, even when some are already known in conversation. Assignment does not increase authority. When explaining a proposed claim, make these required fields and the before/after overlap checks explicit.
|
|
162
201
|
|
|
163
202
|
Record scope boundaries and dependencies, then read back the claim, links and any competing claims. Issue claims are cooperative, not atomic locks: another agent may have claimed overlapping work since your first read. Reconcile that race before dependent implementation. If another contributor has claimed the same work, agree a split or handoff in the increment thread before overlapping implementation. An inactive or old claim is not permission to take over silently. If assignment is unavailable, record the intended owner and unassigned state, request the owner’s help through the agreed coordination channel when authorized, and continue only work whose ownership is clear. Never claim an assignment or board update succeeded without reading it back.
|
|
164
203
|
|
|
165
204
|
## Reconcile tracking at work checkpoints
|
|
166
205
|
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
cadence
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
are both
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
206
|
+
During an active work window, follow this coordination sequence while coding
|
|
207
|
+
or waiting:
|
|
208
|
+
|
|
209
|
+
1. Use the agreed, saved discussion-reading cadence. If none exists, propose a
|
|
210
|
+
bounded cadence through the authorized increment thread, obtain agreement
|
|
211
|
+
and verify its saved record. While agreement is pending, continue regular
|
|
212
|
+
bounded reads; a proposal is not agreement.
|
|
213
|
+
2. Also read new increment comments on joining/resuming and at the event
|
|
214
|
+
checkpoints below, including before dependent actions, pushes, scope or
|
|
215
|
+
ownership changes and handovers. Regular reads and event reads are both
|
|
216
|
+
required; neither replaces the other.
|
|
217
|
+
3. Answer relevant questions and handle handoffs through the authorized channel
|
|
218
|
+
and handoff rules below: actual recipient
|
|
219
|
+
acknowledgement and linked task, independent verification of returned
|
|
220
|
+
evidence, and updates to your task's evidence, dependency and next action.
|
|
221
|
+
A posted message is not the recipient's acknowledgement.
|
|
222
|
+
4. If the result materially changes the executable plan, reconcile that revision
|
|
223
|
+
and obtain the five independent reviews before dependent execution. Otherwise
|
|
224
|
+
continue within the assessed plan. Apply the claim table when work is
|
|
225
|
+
exhausted rather than retaining it for discussion reads.
|
|
226
|
+
|
|
227
|
+
These are bounded checks during active work, not a standing poller or a promise
|
|
228
|
+
to wake an idle agent. Use only already-authorized communication channels.
|
|
188
229
|
|
|
189
230
|
At each work checkpoint, reconcile tracking in this order:
|
|
190
231
|
|
|
@@ -213,19 +254,19 @@ source for the selection decision below, not proof of capability or acceptance.
|
|
|
213
254
|
there is no established mirror operation to report pending or unsynchronized.
|
|
214
255
|
Omitted information and API availability establish neither selection nor
|
|
215
256
|
an explicit choice to use no Project.
|
|
216
|
-
2. **Inspect each affected record
|
|
217
|
-
|
|
218
|
-
applicable agent/session, revision and acceptance
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
For a selected
|
|
227
|
-
|
|
228
|
-
|
|
257
|
+
2. **Inspect each affected record before classifying it.** Compare every
|
|
258
|
+
outcome, increment and task with the minimum-information table. Preserve its
|
|
259
|
+
own recorded owner/account, applicable agent/session, revision and acceptance,
|
|
260
|
+
including provisional and completed records. Mark a required value unresolved
|
|
261
|
+
only when inspection cannot establish it; omission from a scenario or summary
|
|
262
|
+
does not establish that saved information is missing. Completion evidence
|
|
263
|
+
does not replace the task's own revision or acceptance. Provisional ownership,
|
|
264
|
+
revision and tentative acceptance imply neither an executable plan nor
|
|
265
|
+
critic approval or completion evidence.
|
|
266
|
+
Record actual scope, status, increment-only Horizon, dependencies/blocker,
|
|
267
|
+
next action and state-appropriate evidence. For a selected/required Project,
|
|
268
|
+
each item's Agent remains its verified owner/session, never an identity
|
|
269
|
+
copied from its parent or child; Status reflects that item's actual work.
|
|
229
270
|
3. **Update and verify.** Make only necessary authorized changes to existing
|
|
230
271
|
records. Read back every changed issue's fields and links, checking both
|
|
231
272
|
directions of parent/dependency relationships. For a selected or required
|
|
@@ -245,7 +286,7 @@ system.
|
|
|
245
286
|
| Join, resume or start implementation | Read current records and discussion; correct stale status, scope and ownership before dependent implementation. Set the active task and increment In progress when useful work starts. Complete missing selected Project setup or record its precise unavailable operation. |
|
|
246
287
|
| Material milestone or failed verification | Record the actual result and evidence before the next dependent action. Keep In progress while useful repair remains; a failed check alone does not mean Blocked. |
|
|
247
288
|
| Scope, dependency, plan or horizon change | Update affected briefs, native relationships and increment horizons; remove superseded active horizons. Obtain the required reviews before materially revised execution. |
|
|
248
|
-
| Block, hand off, finish or yield the active work window |
|
|
289
|
+
| Block, hand off, finish or yield the active work window | Apply the claim table, saving the gap, next action/owner or acceptance evidence and verifying any required release. Reconcile the increment as well as the task; do not leave stale status or next action. |
|
|
249
290
|
|
|
250
291
|
For a selected or required Project, when an operation is unavailable, record
|
|
251
292
|
the affected view/field/item,
|
|
@@ -281,7 +322,7 @@ When an authorized owner must complete a pending Project operation, request it t
|
|
|
281
322
|
|
|
282
323
|
## Verify, learn and replan as the outcome owner
|
|
283
324
|
|
|
284
|
-
Post acceptance evidence before completing a task. Preserve its actual recorded acceptance: do not invent a later release check as a repair-task completion condition, or remove an established condition to finish early. At handoff,
|
|
325
|
+
Post acceptance evidence before completing a task. Preserve its actual recorded acceptance: do not invent a later release check as a repair-task completion condition, or remove an established condition to finish early. At handoff, apply the claim table; an explicit ownership transfer additionally needs the identified recipient's acknowledgement. Do not report both releasing and retaining the same claim. The increment owner verifies the whole increment against its criteria before closing it; task completion alone does not establish delivery. Publication, installed behavior and production/customer verification remain separate evidence stages where applicable.
|
|
285
326
|
|
|
286
327
|
After a verified increment, or earlier when evidence invalidates the plan, the outcome owner:
|
|
287
328
|
|
|
@@ -25,7 +25,7 @@ Read the relevant current evidence, project instructions, decisions, jobs, risk
|
|
|
25
25
|
|
|
26
26
|
Use SMART to make the objective specific, measurable through observable completion evidence, achievable against known constraints, relevant to the user's job, and time-bound using the user's stated deadline or timeframe. Qualitative evidence can establish success. Surface feasibility uncertainty instead of weakening the objective or promising certainty. Never invent numerical targets or dates. Preserve stated timing and prefer relative wording. Any added date must match verified context and its weekday. Never turn a guessed date into a new timing interview. If neither a time bound nor an explicit decision to omit one is established, ask one timing question and wait. If the user declines a time bound, record the exception honestly rather than claiming full SMART compliance.
|
|
27
27
|
|
|
28
|
-
If
|
|
28
|
+
If outcome information is unclear or missing, interview the user: **ask one focused question, then stop and wait for their answer before asking the next**. Select the next question from their actual answer and remaining uncertainty. Do not bundle questions, answer on their behalf, invent their intent, or resolve ambiguity by selecting a solution. Bounded read-only investigation can establish facts within existing authority.
|
|
29
29
|
|
|
30
30
|
One question requests **one missing fact**. Do not combine multiple information needs, such as who benefits and what is wrong, into a multipart question. Sharing a topic or using one question mark does not make it one question.
|
|
31
31
|
|
|
@@ -113,6 +113,6 @@ Finish when the objective's completion evidence is satisfied. Record the verifie
|
|
|
113
113
|
|
|
114
114
|
Recording verified completion is a terminal status update, not another executable plan. Any newly proposed work still needs its own assessed plan.
|
|
115
115
|
|
|
116
|
-
|
|
116
|
+
Before handing back a blocker, finish useful authorized work, including running checks. Preserve work, distinguish completed increments from unfinished outcomes, and report the precise missing result, capability, authority or irreducible user action. Resume from fresh evidence when the blocker clears; do not restart completed effects.
|
|
117
117
|
|
|
118
118
|
Communicate the objective, consequential plan changes, decisions requiring input, exact blockers, and verified outcomes concisely. Avoid narrating routine commands or every review and wait.
|
|
@@ -128,21 +128,62 @@ Give the existing planning critic the saved outcome and affected increment recor
|
|
|
128
128
|
|
|
129
129
|
**Horizon belongs only to increments**: each planned or active increment has exactly one of Now, Next or Later. Remove completed or superseded increments from active horizons while preserving their prior position in history. **Status** separately describes execution, such as ready, in progress, blocked or done. A blocked Now increment does not automatically become Next; a completed task does not become a completed outcome. Outcomes and tasks do not inherit Horizon. Map these meanings to existing repository labels or Project fields. Replace the previous horizon when replanning rather than accumulating contradictory values.
|
|
130
130
|
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
131
|
+
Maintain parent/child and prerequisite relationships in this order:
|
|
132
|
+
|
|
133
|
+
1. Inspect the actual relationship and the precise result that unlocks a start,
|
|
134
|
+
stage or completion. Read current native sub-issue and blocked-by state when
|
|
135
|
+
supported. A native write denial proves neither presence nor absence:
|
|
136
|
+
preserve known links and keep unreadable native state unknown.
|
|
137
|
+
2. Keep completion dependencies acyclic. A prerequisite cannot require its
|
|
138
|
+
dependent's result to close. Propose changed task boundaries and acceptance
|
|
139
|
+
in the increment thread; the increment owner records agreement with affected
|
|
140
|
+
task owners before applying them. Obtain the five independent reviews before
|
|
141
|
+
materially revised execution. Give each task an independently verifiable
|
|
142
|
+
result and retain the combined results in increment acceptance.
|
|
143
|
+
3. After any required agreement and reviews, use native links when supported;
|
|
144
|
+
create a missing required link or update a changed one when authorized.
|
|
145
|
+
Verify saved native state and both relationship directions. If operations are
|
|
146
|
+
unavailable, record their exact limitation plus reciprocal parent/child or
|
|
147
|
+
prerequisite/dependent text links on both affected issues; text is not proof
|
|
148
|
+
of native state. Request capable help through an authorized channel when
|
|
149
|
+
useful, without inventing a helper or widening access.
|
|
150
|
+
4. Reassess actual useful work and status under the claim table below. A Ready
|
|
151
|
+
or In progress task may prepare while a real prerequisite remains open;
|
|
152
|
+
preserve its precise unlock condition and required evidence. Independently
|
|
153
|
+
verify the prerequisite result before clearing that condition and proceeding
|
|
154
|
+
with the dependent stage. Administrative issue closure is not another
|
|
155
|
+
prerequisite unless recorded acceptance or a project rule requires it.
|
|
156
|
+
|
|
157
|
+
Optional Project membership and fields mirror issue state; do not create them
|
|
158
|
+
merely because this protocol mentions them.
|
|
159
|
+
|
|
160
|
+
Replan task boundaries at any stage when evidence changes what work is needed. Coordinate narrowed, split, replaced or dropped scope with the increment owner and affected task owners. Close redundant or superseded issues as **not planned**, with the reason and successor links; never mark undelivered work Done merely to retire it. Before removing a dependency, move still-required acceptance evidence to the appropriate task and retain it in increment acceptance. Remove only genuinely obsolete native dependencies and verify the saved result; preserve prerequisites that still constrain the revised work. Keep task briefs, links, ownership and selected Project fields truthful. Preserve retired tasks' Agent attribution and saved history; update only fields needed to reflect their retirement. Never blanket-clear a closed task's Project fields. Clear an active Horizon only for completed or superseded increments. Routine task reconciliation within the assessed outcome and authority needs no new user approval; materially revised executable work still requires the five independent plan reviews.
|
|
161
|
+
|
|
162
|
+
### Status and contribution-claim decision
|
|
163
|
+
|
|
164
|
+
Use this table whenever work starts, blocks, finishes or is handed over. Inspect
|
|
165
|
+
scope, inputs and actual useful authorized in-task steps first: a stored Blocked
|
|
166
|
+
status alone does not establish exhaustion. Genuine assigned watcher duties
|
|
167
|
+
count as useful work; waiting for an unverified response or routine discussion
|
|
168
|
+
reads alone do not retain an exhausted implementation reservation.
|
|
169
|
+
|
|
170
|
+
| Actual state of the claimed task | Status | Assignment and saved result |
|
|
140
171
|
| --- | --- | --- |
|
|
141
|
-
| Recorded acceptance is verified with evidence | Done |
|
|
172
|
+
| Recorded acceptance is verified with evidence | Done | Post acceptance evidence, finish and preserve attribution history. |
|
|
142
173
|
| Useful authorized in-task work remains | In progress | Retain the single claim and do that work. |
|
|
143
|
-
| A required input is unavailable and no useful authorized in-task step remains | Blocked |
|
|
174
|
+
| A required input is unavailable and no useful authorized in-task step remains | Blocked | Save the blocker, evidence, unlock condition and handover; remove your assignment and read back its removal. Preserve historical attribution. |
|
|
175
|
+
|
|
176
|
+
One contribution claim is a ceiling, not a retention requirement. A blocked
|
|
177
|
+
assignment still counts until release is verified. Apply the table before
|
|
178
|
+
claiming another task; never reserve queued tasks. Outcome/increment ownership
|
|
179
|
+
does not reserve contributions. Agents sharing an account remain distinct by
|
|
180
|
+
their recorded agent/session. Keep actionable unclaimed work Ready/Unclaimed;
|
|
181
|
+
a blocked task does not block every contribution. Never invent busywork.
|
|
144
182
|
|
|
145
|
-
|
|
183
|
+
If assignment mutation or verification is unavailable, record the exact pending
|
|
184
|
+
release and known claim state, use an authorized owner/channel when available,
|
|
185
|
+
and do not claim release or take another task while still assigned. Reassess
|
|
186
|
+
when evidence changes.
|
|
146
187
|
|
|
147
188
|
## Join, claim and contribute
|
|
148
189
|
|
|
@@ -151,40 +192,40 @@ Use this contribution lifecycle:
|
|
|
151
192
|
1. Read the outcome, current Now revision, discussion, dependencies and claims. Reconcile stale scope before dependent work.
|
|
152
193
|
2. Choose a bounded useful result and announce its acceptance and file/operation boundary in the increment thread. Resolve overlap, shared operations or authority questions with affected owners. A non-overlapping task within the assessed Now needs no allocator approval.
|
|
153
194
|
3. Reuse a matching unclaimed task, or create your own just before work. Apply the established task-kind marker (`kind:task` by default). Assign it to the **actual authenticated account** and record the **specific agent/session** and native links; read back kind, assignment, claim and links and recheck competing work. For a selected or required Project, explicitly add the task and read back its membership and applicable fields so it matches the saved view.
|
|
154
|
-
4. Execute within the assessed plan and authority
|
|
195
|
+
4. Execute within the assessed plan and authority; apply the status and contribution-claim decision above, including saved release when exhausted.
|
|
155
196
|
5. Choose and document the next useful contribution from the remaining outcome gap, then repeat these checks before claiming it.
|
|
156
197
|
|
|
157
198
|
A starting battle plan exposes likely work, dependencies and parallel opportunities without precreating, assigning or reserving every future task. The increment owner keeps acceptance, sequence and integration clear and resolves overlap/dependencies. Explicit assignments and handoffs remain valid. Two agents sharing an account are distinct contributors. Checklists suffice for routine steps; do not create a task for every command. Task creation within assessed scope requires no fresh human approval.
|
|
158
199
|
|
|
159
|
-
**One contribution claim is a ceiling, not a retention requirement.** A blocked assignment still counts until its release is verified. For an unfinished task, when no useful authorized in-task step remains, hand over the remaining gap, remove your assignment and read back its removal; do not retain it merely because its dependency is unresolved. Preserve genuine assigned watcher duties; routine discussion reads alone do not justify retaining an exhausted reservation. Finish, explicitly hand over or release the current assignment before claiming another. Do not reserve queued tasks. Outcome or increment coordination ownership does not reserve contribution tasks. Agents sharing an account remain distinct through their recorded agent/session identities.
|
|
160
|
-
|
|
161
200
|
Before declaring a contribution ready to start, complete this claim receipt: **no other contribution assignment held; parent increment; current assessed plan revision; non-overlapping scope; dependencies (or explicitly none); actual account; distinct agent/session; saved claim and reciprocal-link readback; competing-claim recheck.** Record all fields on the task, even when some are already known in conversation. Assignment does not increase authority. When explaining a proposed claim, make these required fields and the before/after overlap checks explicit.
|
|
162
201
|
|
|
163
202
|
Record scope boundaries and dependencies, then read back the claim, links and any competing claims. Issue claims are cooperative, not atomic locks: another agent may have claimed overlapping work since your first read. Reconcile that race before dependent implementation. If another contributor has claimed the same work, agree a split or handoff in the increment thread before overlapping implementation. An inactive or old claim is not permission to take over silently. If assignment is unavailable, record the intended owner and unassigned state, request the owner’s help through the agreed coordination channel when authorized, and continue only work whose ownership is clear. Never claim an assignment or board update succeeded without reading it back.
|
|
164
203
|
|
|
165
204
|
## Reconcile tracking at work checkpoints
|
|
166
205
|
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
cadence
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
are both
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
206
|
+
During an active work window, follow this coordination sequence while coding
|
|
207
|
+
or waiting:
|
|
208
|
+
|
|
209
|
+
1. Use the agreed, saved discussion-reading cadence. If none exists, propose a
|
|
210
|
+
bounded cadence through the authorized increment thread, obtain agreement
|
|
211
|
+
and verify its saved record. While agreement is pending, continue regular
|
|
212
|
+
bounded reads; a proposal is not agreement.
|
|
213
|
+
2. Also read new increment comments on joining/resuming and at the event
|
|
214
|
+
checkpoints below, including before dependent actions, pushes, scope or
|
|
215
|
+
ownership changes and handovers. Regular reads and event reads are both
|
|
216
|
+
required; neither replaces the other.
|
|
217
|
+
3. Answer relevant questions and handle handoffs through the authorized channel
|
|
218
|
+
and handoff rules below: actual recipient
|
|
219
|
+
acknowledgement and linked task, independent verification of returned
|
|
220
|
+
evidence, and updates to your task's evidence, dependency and next action.
|
|
221
|
+
A posted message is not the recipient's acknowledgement.
|
|
222
|
+
4. If the result materially changes the executable plan, reconcile that revision
|
|
223
|
+
and obtain the five independent reviews before dependent execution. Otherwise
|
|
224
|
+
continue within the assessed plan. Apply the claim table when work is
|
|
225
|
+
exhausted rather than retaining it for discussion reads.
|
|
226
|
+
|
|
227
|
+
These are bounded checks during active work, not a standing poller or a promise
|
|
228
|
+
to wake an idle agent. Use only already-authorized communication channels.
|
|
188
229
|
|
|
189
230
|
At each work checkpoint, reconcile tracking in this order:
|
|
190
231
|
|
|
@@ -213,19 +254,19 @@ source for the selection decision below, not proof of capability or acceptance.
|
|
|
213
254
|
there is no established mirror operation to report pending or unsynchronized.
|
|
214
255
|
Omitted information and API availability establish neither selection nor
|
|
215
256
|
an explicit choice to use no Project.
|
|
216
|
-
2. **Inspect each affected record
|
|
217
|
-
|
|
218
|
-
applicable agent/session, revision and acceptance
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
For a selected
|
|
227
|
-
|
|
228
|
-
|
|
257
|
+
2. **Inspect each affected record before classifying it.** Compare every
|
|
258
|
+
outcome, increment and task with the minimum-information table. Preserve its
|
|
259
|
+
own recorded owner/account, applicable agent/session, revision and acceptance,
|
|
260
|
+
including provisional and completed records. Mark a required value unresolved
|
|
261
|
+
only when inspection cannot establish it; omission from a scenario or summary
|
|
262
|
+
does not establish that saved information is missing. Completion evidence
|
|
263
|
+
does not replace the task's own revision or acceptance. Provisional ownership,
|
|
264
|
+
revision and tentative acceptance imply neither an executable plan nor
|
|
265
|
+
critic approval or completion evidence.
|
|
266
|
+
Record actual scope, status, increment-only Horizon, dependencies/blocker,
|
|
267
|
+
next action and state-appropriate evidence. For a selected/required Project,
|
|
268
|
+
each item's Agent remains its verified owner/session, never an identity
|
|
269
|
+
copied from its parent or child; Status reflects that item's actual work.
|
|
229
270
|
3. **Update and verify.** Make only necessary authorized changes to existing
|
|
230
271
|
records. Read back every changed issue's fields and links, checking both
|
|
231
272
|
directions of parent/dependency relationships. For a selected or required
|
|
@@ -245,7 +286,7 @@ system.
|
|
|
245
286
|
| Join, resume or start implementation | Read current records and discussion; correct stale status, scope and ownership before dependent implementation. Set the active task and increment In progress when useful work starts. Complete missing selected Project setup or record its precise unavailable operation. |
|
|
246
287
|
| Material milestone or failed verification | Record the actual result and evidence before the next dependent action. Keep In progress while useful repair remains; a failed check alone does not mean Blocked. |
|
|
247
288
|
| Scope, dependency, plan or horizon change | Update affected briefs, native relationships and increment horizons; remove superseded active horizons. Obtain the required reviews before materially revised execution. |
|
|
248
|
-
| Block, hand off, finish or yield the active work window |
|
|
289
|
+
| Block, hand off, finish or yield the active work window | Apply the claim table, saving the gap, next action/owner or acceptance evidence and verifying any required release. Reconcile the increment as well as the task; do not leave stale status or next action. |
|
|
249
290
|
|
|
250
291
|
For a selected or required Project, when an operation is unavailable, record
|
|
251
292
|
the affected view/field/item,
|
|
@@ -281,7 +322,7 @@ When an authorized owner must complete a pending Project operation, request it t
|
|
|
281
322
|
|
|
282
323
|
## Verify, learn and replan as the outcome owner
|
|
283
324
|
|
|
284
|
-
Post acceptance evidence before completing a task. Preserve its actual recorded acceptance: do not invent a later release check as a repair-task completion condition, or remove an established condition to finish early. At handoff,
|
|
325
|
+
Post acceptance evidence before completing a task. Preserve its actual recorded acceptance: do not invent a later release check as a repair-task completion condition, or remove an established condition to finish early. At handoff, apply the claim table; an explicit ownership transfer additionally needs the identified recipient's acknowledgement. Do not report both releasing and retaining the same claim. The increment owner verifies the whole increment against its criteria before closing it; task completion alone does not establish delivery. Publication, installed behavior and production/customer verification remain separate evidence stages where applicable.
|
|
285
326
|
|
|
286
327
|
After a verified increment, or earlier when evidence invalidates the plan, the outcome owner:
|
|
287
328
|
|