@codetreker/daynight 0.26.0 → 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 +128 -17
- package/dist/api/client.d.ts +7 -2
- package/dist/api/client.js +46 -18
- package/dist/api/client.js.map +1 -1
- package/dist/api/index.d.ts +1 -0
- package/dist/api/index.js +1 -0
- package/dist/api/index.js.map +1 -1
- package/dist/api/json.js +27 -6
- package/dist/api/json.js.map +1 -1
- package/dist/api/parse.d.ts +4 -6
- package/dist/api/parse.js +51 -93
- package/dist/api/parse.js.map +1 -1
- package/dist/api/resource-path.d.ts +1 -0
- package/dist/api/resource-path.js +8 -0
- package/dist/api/resource-path.js.map +1 -0
- package/dist/api/task-properties.d.ts +7 -0
- package/dist/api/task-properties.js +81 -0
- package/dist/api/task-properties.js.map +1 -0
- package/dist/api/types.d.ts +95 -6
- package/dist/api/validation.d.ts +15 -0
- package/dist/api/validation.js +43 -0
- package/dist/api/validation.js.map +1 -0
- package/dist/cli/schema.d.ts +3 -0
- package/dist/cli/schema.js +14 -4
- package/dist/cli/schema.js.map +1 -1
- package/dist/commands/completion/bash.d.ts +1 -1
- package/dist/commands/completion/bash.js +6 -3
- package/dist/commands/completion/bash.js.map +1 -1
- package/dist/commands/completion/zsh.d.ts +1 -1
- package/dist/commands/completion/zsh.js +7 -7
- package/dist/commands/completion/zsh.js.map +1 -1
- package/dist/commands/skill/skills/using-daynight/SKILL.md +52 -162
- package/dist/commands/skill/skills/using-daynight/references/authorization.md +36 -0
- package/dist/commands/skill/skills/using-daynight/references/autopilot-managed-task.md +77 -193
- package/dist/commands/skill/skills/using-daynight/references/create-task.md +31 -186
- package/dist/commands/skill/skills/using-daynight/references/final-acceptance.md +25 -0
- package/dist/commands/skill/skills/using-daynight/references/goal.md +46 -243
- package/dist/commands/skill/skills/using-daynight/references/handbook.md +38 -294
- package/dist/commands/skill/skills/using-daynight/references/handoff.md +33 -91
- package/dist/commands/skill/skills/using-daynight/references/project-management.md +24 -0
- package/dist/commands/skill/skills/using-daynight/references/run-task.md +18 -59
- package/dist/commands/skill/skills/using-daynight/references/setup.md +16 -0
- package/dist/commands/skill/skills/using-daynight/references/task-content.md +80 -177
- package/dist/commands/skill/skills/using-daynight/references/task-execution.md +34 -126
- package/dist/commands/skill/skills/using-daynight/references/task-management.md +162 -0
- package/dist/commands/skill/skills/using-daynight/references/write-safety.md +34 -0
- package/dist/commands/task/command.js +12 -14
- package/dist/commands/task/command.js.map +1 -1
- package/dist/commands/task/definition.js +32 -13
- package/dist/commands/task/definition.js.map +1 -1
- package/dist/commands/task/property.d.ts +6 -0
- package/dist/commands/task/property.js +51 -0
- package/dist/commands/task/property.js.map +1 -0
- package/dist/commands/task/rendering.d.ts +4 -1
- package/dist/commands/task/rendering.js +35 -9
- package/dist/commands/task/rendering.js.map +1 -1
- package/dist/commands/worker/control.js +10 -6
- package/dist/commands/worker/control.js.map +1 -1
- package/dist/commands/worker/coordinator.d.ts +3 -1
- package/dist/commands/worker/coordinator.js +28 -17
- package/dist/commands/worker/coordinator.js.map +1 -1
- package/dist/commands/worker/herdr/command.d.ts +11 -2
- package/dist/commands/worker/herdr/command.js +23 -8
- package/dist/commands/worker/herdr/command.js.map +1 -1
- package/dist/commands/worker/herdr/instance.d.ts +5 -1
- package/dist/commands/worker/herdr/instance.js +30 -0
- package/dist/commands/worker/herdr/instance.js.map +1 -1
- package/dist/commands/worker/herdr/preflight.js +4 -6
- package/dist/commands/worker/herdr/preflight.js.map +1 -1
- package/dist/commands/worker/herdr/version-probe.d.ts +13 -0
- package/dist/commands/worker/herdr/version-probe.js +21 -0
- package/dist/commands/worker/herdr/version-probe.js.map +1 -0
- package/dist/commands/worker/herdr.js +2 -6
- package/dist/commands/worker/herdr.js.map +1 -1
- package/dist/commands/worker/index.d.ts +2 -0
- package/dist/commands/worker/index.js +1 -1
- package/dist/commands/worker/index.js.map +1 -1
- package/dist/commands/worker/remote.d.ts +3 -1
- package/dist/commands/worker/remote.js +11 -6
- package/dist/commands/worker/remote.js.map +1 -1
- package/dist/commands/worker/reporter.d.ts +14 -0
- package/dist/commands/worker/reporter.js +174 -0
- package/dist/commands/worker/reporter.js.map +1 -0
- package/dist/commands/worker/runtime.d.ts +2 -0
- package/dist/commands/worker/runtime.js +14 -1
- package/dist/commands/worker/runtime.js.map +1 -1
- package/dist/commands/worker/telemetry.d.ts +22 -0
- package/dist/commands/worker/telemetry.js +265 -0
- package/dist/commands/worker/telemetry.js.map +1 -0
- package/package.json +2 -2
|
@@ -1,182 +1,85 @@
|
|
|
1
1
|
# Task content standard
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
the
|
|
6
|
-
target repository's document and language rules.
|
|
3
|
+
Applies to creation, breakdown, handoff, and execution.
|
|
4
|
+
Descriptions and their actual references should let an independent reader understand the task without the original chat, private worktrees, or temporary files.
|
|
5
|
+
Follow the target repository's documentation and language rules.
|
|
7
6
|
|
|
8
7
|
## Task and session boundary
|
|
9
8
|
|
|
10
|
-
Tasks
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
|
29
|
-
|
|
|
30
|
-
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
## Resolve and read sources
|
|
88
|
-
|
|
89
|
-
Description-relative links and images start at the current task's attachment
|
|
90
|
-
root; references inside a Markdown attachment start at its containing directory.
|
|
91
|
-
Keep paths inside the task root and preserve case and resource identity. Confirm
|
|
92
|
-
uploaded contents before adding their links. Shared task sources identify the
|
|
93
|
-
owning task ID and content location: its description and applicable sections for
|
|
94
|
-
inline content, or the complete attachment path for an actual attachment. Name
|
|
95
|
-
the whole description when all of it applies; sections only delimit a larger
|
|
96
|
-
source and do not require invented headings. Read source task descriptions with
|
|
97
|
-
`task show --json`; list and read attachment contents separately with the
|
|
98
|
-
installed attachment commands. Repository documents need accurate paths and the
|
|
99
|
-
required verified immutable source revision. State the sections, requirements,
|
|
100
|
-
or interfaces applicable to this task when a source covers more. Do not invent
|
|
101
|
-
an attachment path for inline content, relocate or copy it merely to satisfy a
|
|
102
|
-
reference format, or invent a URL scheme, cross-task relative link, or fixed
|
|
103
|
-
service host.
|
|
104
|
-
|
|
105
|
-
Read the required source contents, including further references needed for the
|
|
106
|
-
current stage. Track already-read resource identities to avoid circular reading.
|
|
107
|
-
A reference cycle that supplies no actual required content cannot pass. Limit
|
|
108
|
-
traversal to this task's requirements; it does not authorize redesigning a Goal
|
|
109
|
-
or executing related tasks. Resolve material conflicts between the description
|
|
110
|
-
and sources or between sources before declaring the content sufficient.
|
|
111
|
-
|
|
112
|
-
Every Goal delivery task's description must directly list the architecture task
|
|
113
|
-
ID and all required architecture source locations, including indirect successors.
|
|
114
|
-
For inline architecture, name the source task's description and applicable
|
|
115
|
-
sections. For each actual required attachment document, include its full path;
|
|
116
|
-
for repository architecture, retain the owning task ID and a verified immutable
|
|
117
|
-
reference. An entry only in another task or inside an attachment is insufficient.
|
|
118
|
-
[The Goal protocol](goal.md) owns this additional source-index requirement and
|
|
119
|
-
its registration checks.
|
|
120
|
-
|
|
121
|
-
## Input and output contracts
|
|
122
|
-
|
|
123
|
-
Describe actual exchanges rather than inventing an interface to fill a template.
|
|
124
|
-
As applicable, include fields, types, requiredness, format or version, examples,
|
|
125
|
-
and the units, states, errors, and null semantics needed by consumers. APIs, CLI
|
|
126
|
-
output, files, database records, attachments, and design conclusions can all be
|
|
127
|
-
exchanged outputs. Check the relevant producer and consumer explanations for
|
|
128
|
-
consistency and distinguish their responsibilities.
|
|
129
|
-
|
|
130
|
-
For example, an upload protocol may define a required multipart `file`, a
|
|
131
|
-
10 MiB limit, a `201` response containing a UUID `id`, `name`, and byte-count
|
|
132
|
-
`size`, a nonretryable `413 file_too_large`, and a `503 temporarily_unavailable`
|
|
133
|
-
that permits user-initiated retry. Provider and consumer tasks reference the same
|
|
134
|
-
protocol and state their own delivery locations and availability.
|
|
135
|
-
|
|
136
|
-
Necessary direct prerequisites remain in the complete `dependsOn` set and its
|
|
137
|
-
`externalDependsOn` subset, following
|
|
138
|
-
[the handbook's dependency reduction rule](handbook.md#dependency-reduction).
|
|
139
|
-
Contract source identities do not form a second complete dependency list, and a
|
|
140
|
-
source reference does not create an execution dependency. Use
|
|
141
|
-
[the handbook](handbook.md) for relationship semantics. Existing status, PR,
|
|
142
|
-
permission, platform, and worker fields keep their own service semantics; do not
|
|
143
|
-
copy them into prose as a second operational record.
|
|
144
|
-
|
|
145
|
-
## Apply the current stage
|
|
146
|
-
|
|
147
|
-
| Stage | Sufficient starting content | Stage results |
|
|
148
|
-
|---|---|---|
|
|
149
|
-
| Requirements discussion | Known problem, outcome, scope, constraints, open requirements questions, and completion conditions | Current and confirmed requirements and applicable prototype |
|
|
150
|
-
| Solution or architecture discussion | Confirmed requirements, applicable prototype, design questions, intended deliverables, and completion conditions | Current architecture, key decisions, and delivery breakdown |
|
|
151
|
-
| Implementation or document delivery | Defined requirements and scope, required design and applicable prototype, contracts, deliverables, and acceptance criteria | The scoped deliverable and its actual location or version |
|
|
152
|
-
| Independent final acceptance | Whole agreed requirements and confirmed changes, actual deliveries, and acceptance criteria | Requirement-based conclusions, defects, and unverified items |
|
|
153
|
-
|
|
154
|
-
A stage's unfinished outputs are not prerequisites for starting that stage.
|
|
155
|
-
Preserve human confirmation as an actual completion condition where required;
|
|
156
|
-
the execution protocol handles the confirmation action and advancement.
|
|
157
|
-
Explicit prerequisite-produced implementation outputs may still be pending when
|
|
158
|
-
preparing a blocked task, provided the necessary design and agreed interfaces
|
|
159
|
-
already define the successor's work. Do not label future output as an existing
|
|
160
|
-
readable input. Execution still waits for real prerequisites and required inputs.
|
|
161
|
-
|
|
162
|
-
## Check sufficiency
|
|
163
|
-
|
|
164
|
-
Before reporting creation, breakdown, or handoff ready, check the task
|
|
165
|
-
definition, source readability and applicability, existing result ownership, and
|
|
166
|
-
the stage's additional conditions. Check both directions: session context stays
|
|
167
|
-
out, and actual requirements, required design inputs, and task results remain
|
|
168
|
-
complete. Unknown requirements, design choices, acceptance thresholds, and
|
|
169
|
-
interface decisions are concrete blockers, not details to invent. Only organize
|
|
170
|
-
confirmed information within existing authorization. A material scope or
|
|
171
|
-
behavior change requires user confirmation.
|
|
172
|
-
|
|
173
|
-
Apply the boundary when reading existing material and when authoring or
|
|
174
|
-
rewriting authorized task content. It does not authorize bulk edits of historical
|
|
175
|
-
tasks or automatic changes to fields, permissions, or recorded history.
|
|
176
|
-
|
|
177
|
-
Task versions protect task metadata, not independently mutable attachments or
|
|
178
|
-
cross-task references. Verify mutable contents before enabling permission and
|
|
179
|
-
read the required contents again before execution. Reassess affected content
|
|
180
|
-
when it changes. A content check is not an atomic freeze or permanent
|
|
181
|
-
certification of future sources. [Handoff](handoff.md) owns permission-update
|
|
182
|
-
and read-only re-audit behavior.
|
|
9
|
+
Tasks store what must be implemented and delivered; sessions store how to execute or discuss it.
|
|
10
|
+
Apply the same boundary to descriptions, attachments, and referenced material.
|
|
11
|
+
|
|
12
|
+
| Store in the task | Store in the session or relevant platform |
|
|
13
|
+
| --- | --- |
|
|
14
|
+
| Objectives, requirements, scope, delivery constraints, required inputs, acceptance criteria | Execution steps, tool choices, agent assignments, operational authorization |
|
|
15
|
+
| Current requirements or architecture, accepted conclusions and essential rationale, substantive open questions | Discussion rounds, confirmation process, debugging history, CI and review progress |
|
|
16
|
+
| Deliverables, immutable revisions, acceptance conclusions, key observations and limitations | Worktree, HEAD, claim, blocker, waiting, and recovery context |
|
|
17
|
+
|
|
18
|
+
Classify by purpose, not by filenames or words such as "plan" or "method".
|
|
19
|
+
User-requested migration designs, test strategies, and operating manuals can be deliverables; the session steps that produce them do not belong in tasks.
|
|
20
|
+
Do not invent delivery requirements to justify uploading execution logs.
|
|
21
|
+
Operational authorization still constrains current behavior, but does not become task content merely because a later session needs it.
|
|
22
|
+
|
|
23
|
+
## Definitions and results
|
|
24
|
+
|
|
25
|
+
The description and readable references together provide the following information, without mandatory headings or empty templates:
|
|
26
|
+
|
|
27
|
+
| Information | Content |
|
|
28
|
+
| --- | --- |
|
|
29
|
+
| Objectives and requirements | Specific problem, expected outcome, required behavior, and requirement IDs when needed. |
|
|
30
|
+
| Scope and constraints | This task's responsibilities, delivery boundaries, and applicable shared constraints. |
|
|
31
|
+
| Inputs and sources | Source identifiers, locations, applicable sections, and purposes of genuinely required material. |
|
|
32
|
+
| Deliverables and contracts | Outputs, read locations, and semantics needed by producers and consumers; state when there is no exchange between tasks. |
|
|
33
|
+
| Acceptance criteria | Observable completion conditions, success and failure behavior, thresholds, and human confirmation points. |
|
|
34
|
+
|
|
35
|
+
The description must identify this task's specific work and where to find its sources.
|
|
36
|
+
When attachment delivery is not specified, complete inline content needs no primary attachment; references or a mix of inline content and references are also valid.
|
|
37
|
+
Do not duplicate complete documents.
|
|
38
|
+
The [complete delivery standard](autopilot-managed-task.md#complete-delivery-standard) governs managed tasks' attachment and separate review-file requirements; the general inline-content rule cannot waive them.
|
|
39
|
+
Generic questions, unexplained links, unreadable sources, or "see the previous discussion" are insufficient.
|
|
40
|
+
|
|
41
|
+
Save stage results promptly: current reviewable artifacts, accepted content and its effective status, actual deliverables, acceptance conclusions, and important limitations.
|
|
42
|
+
Each detailed explanation has one owner; rewrite it coherently when it changes rather than accumulating logs.
|
|
43
|
+
The requirements stage does not require completed requirements in advance, nor does the design stage require a completed design.
|
|
44
|
+
Do not present future prerequisite outputs as existing inputs. See the [Goal protocol](goal.md) for stage requirements.
|
|
45
|
+
|
|
46
|
+
## Attachments and references
|
|
47
|
+
|
|
48
|
+
Task details contain neither an attachment listing nor attachment bytes; use `task attachment list/read` separately.
|
|
49
|
+
Uploading to the same path replaces the file.
|
|
50
|
+
See [write safety](write-safety.md#attachments-and-multi-step-operations) for content concurrency limits.
|
|
51
|
+
|
|
52
|
+
Relative links and images in a description resolve from this task's attachment root; references inside a Markdown attachment resolve from the file's directory.
|
|
53
|
+
Preserve case and actual resource paths, and do not escape the task root.
|
|
54
|
+
Upload and read back resources before adding links.
|
|
55
|
+
Preserve valid relative locations for prototype HTML, CSS, JavaScript, images, and other resources, and follow the [prototype requirements](create-task.md#prepare-content).
|
|
56
|
+
|
|
57
|
+
Keep shared inputs in their owning tasks and cite the owning task ID and source location: identify the description and applicable sections for inline content, the full path for actual attachments, and the exact path and required, verified immutable revision reference for repository sources.
|
|
58
|
+
Read source descriptions with `task show --json` and read attachments separately.
|
|
59
|
+
The whole description may be referenced when no section restriction is needed.
|
|
60
|
+
Do not invent attachments, cross-task relative links, URL schemes, or fixed service hosts, or copy or move content merely to satisfy formatting requirements.
|
|
61
|
+
|
|
62
|
+
Read further references genuinely needed by the current task, tracking resources already read to avoid cycles.
|
|
63
|
+
Reference cycles without substantive content cannot pass checks; resolve substantive conflicts between sources before declaring inputs sufficient.
|
|
64
|
+
See the [Goal protocol](goal.md#register-the-delivery-breakdown) for the additional architecture-index requirements for every Goal delivery task.
|
|
65
|
+
|
|
66
|
+
## Markdown and exchange contracts
|
|
67
|
+
|
|
68
|
+
Descriptions use Markdown; the Web renders CommonMark/GFM and displays raw HTML as text.
|
|
69
|
+
The CLI/API preserves the original string and has no format field.
|
|
70
|
+
Preserve newlines, code, syntax, and valid references when replacing the full content.
|
|
71
|
+
|
|
72
|
+
Describe only exchanges that actually exist, specifying fields, types, requiredness, formats or versions, examples, units, statuses, errors, and null semantics as needed.
|
|
73
|
+
APIs, CLI output, files, databases, attachments, and design conclusions can all form contracts.
|
|
74
|
+
Verify consistent producer and consumer responsibilities; do not invent interfaces to fill a template.
|
|
75
|
+
Citing sources does not create execution dependencies; see [task management](task-management.md#dependency-classification) for relationship rules.
|
|
76
|
+
|
|
77
|
+
## Content sufficiency
|
|
78
|
+
|
|
79
|
+
Before creation, handoff, or execution, check definitions, source readability and applicability, result ownership, and stage requirements.
|
|
80
|
+
Unknown requirements, interface decisions, design choices, and acceptance thresholds are specific gaps, not details to invent.
|
|
81
|
+
If completing a task requires an architecture or execution plan, it is a required input and cannot be omitted on the grounds that "session plans do not belong in tasks"; actual session steps still follow the content boundary.
|
|
82
|
+
Handle input gaps in managed tasks through the [user interaction workflow](autopilot-managed-task.md#request-user-interaction).
|
|
83
|
+
|
|
84
|
+
Organize confirmed information only within the authorized scope; substantive scope or behavior changes require user confirmation.
|
|
85
|
+
This standard does not authorize bulk rewrites of historical tasks or automatic changes to permissions, statuses, or records.
|
|
@@ -1,142 +1,50 @@
|
|
|
1
1
|
# Shared task execution
|
|
2
2
|
|
|
3
|
-
Read this
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
its final status operation, and returning to its caller.
|
|
3
|
+
Read this file after identifying the task in both ordinary and managed execution.
|
|
4
|
+
It governs shared inputs, work, results, and completion conditions; the mode-specific files govern startup, final status operations, interaction, and return.
|
|
5
|
+
Managed execution must also meet its [complete delivery standard](autopilot-managed-task.md#complete-delivery-standard).
|
|
7
6
|
|
|
8
|
-
##
|
|
7
|
+
## Inputs and readiness
|
|
9
8
|
|
|
10
|
-
Read the complete task and
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
Markdown description must identify the concrete current work, responsibility,
|
|
14
|
-
and content sources. Complete inline content needs no primary attachment;
|
|
15
|
-
document-owned and mixed organization are valid when their combined contents
|
|
16
|
-
provide the stage-appropriate task definition. A missing session execution plan
|
|
17
|
-
is not a missing task input.
|
|
9
|
+
Read the complete task, actually required references, and existing results under the [task content standard](task-content.md).
|
|
10
|
+
For Goal tasks, also apply the [stage protocol](goal.md) and check responsibilities, stage inputs, and the architecture index.
|
|
11
|
+
Inspect required prototypes with their assets and actually interact with them.
|
|
18
12
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
shared input references using the owning task ID and description/sections,
|
|
22
|
-
complete paths for actual attachments, or a verified immutable repository
|
|
23
|
-
reference. Read source descriptions through `task show --json` and actual
|
|
24
|
-
attachment contents through the attachment commands; a task read does not load
|
|
25
|
-
attachment inventory or bytes.
|
|
13
|
+
Verify status and all direct prerequisites under [task management](task-management.md), and apply [authorization and scope](authorization.md).
|
|
14
|
+
Execution is not ready when required content or authorization is missing, sources are unreadable, or dependencies are incomplete; report the specific blocker without executing predecessor tasks to bypass it.
|
|
26
15
|
|
|
27
|
-
|
|
28
|
-
its role from the actual task content and context. Apply that stage's input and
|
|
29
|
-
output requirements. Requirements and solution discussions start from their
|
|
30
|
-
stage briefs; the completed requirements, applicable UI prototype, and
|
|
31
|
-
architecture are outputs of the stages that produce them. Delivery tasks
|
|
32
|
-
require the delivered design and applicable prototype. Before implementation,
|
|
33
|
-
read every required architecture source listed in the delivery task's
|
|
34
|
-
description: the owning architecture task's inline description and applicable
|
|
35
|
-
sections, full paths for actual attachment documents, or verified immutable
|
|
36
|
-
repository references. This also applies when the architecture task is only an
|
|
37
|
-
indirect prerequisite. Confirm that the description's references satisfy the
|
|
38
|
-
Goal protocol. When a prototype is a required input, view and exercise it with
|
|
39
|
-
its resources. An unfinished output of the current stage is not a missing input.
|
|
16
|
+
## Work and results
|
|
40
17
|
|
|
41
|
-
|
|
18
|
+
Work within the confirmed scope, design, and acceptance criteria, following the target repository's rules for worktrees, implementation, research, review, verification, and delivery.
|
|
19
|
+
For independent final acceptance, apply the [acceptance standard](final-acceptance.md), not inapplicable development workflows.
|
|
42
20
|
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
express same-chain prerequisites, and external marks distinguish verified
|
|
46
|
-
cross-chain ownership. Both kinds must be done before starting or completing
|
|
47
|
-
work. Classification never grants permission to execute a prerequisite, enable
|
|
48
|
-
automatic execution, or remove a blocker.
|
|
21
|
+
When authorized changes occur, coherently rewrite the actual owning material and affected references, preserving the strength of requirements and acceptance criteria; reconfirm material revisions at the corresponding confirmation points.
|
|
22
|
+
Follow [task management](task-management.md) and [write safety](write-safety.md) when updating fields and editing dependencies.
|
|
49
23
|
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
existing authorization or return the concrete issue. Do not infer requirements
|
|
53
|
-
from a title or silently invent acceptance criteria. Do not execute prerequisites
|
|
54
|
-
as an implicit expansion of the requested task.
|
|
24
|
+
When creating a PR, its description must clearly explain the problem being solved and how the change addresses it.
|
|
25
|
+
If the PR is associated with a Daynight task, include the task's ID and title.
|
|
55
26
|
|
|
56
|
-
|
|
57
|
-
and acceptance criteria and apply the [shared scope constraint](../SKILL.md#shared-constraints)
|
|
58
|
-
to execution and discussion.
|
|
27
|
+
Save the URLs and titles of all required delivery PRs in the complete `properties.pullRequests` list with [property setting](task-management.md#properties), preserving existing entries. Save actual deliverables, current conclusions, and acceptance results in the owning task's material; keep implementation steps, CI, reviews, merge handling, and operational authorization in the session or corresponding platform under the content standard.
|
|
59
28
|
|
|
60
|
-
##
|
|
29
|
+
## Completion conditions
|
|
61
30
|
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
31
|
+
| Task type | Completion conditions |
|
|
32
|
+
| --- | --- |
|
|
33
|
+
| Goal discussion | The user confirms the current material, and the corresponding Goal stage requirements are met; generic PR rules cannot replace or add confirmation requirements. |
|
|
34
|
+
| PR delivery | The hosting platform confirms that all required delivery PRs are merged, and stage acceptance criteria are met; finished code, passing CI, approval, an open PR, or entry into a merge queue is not enough. |
|
|
35
|
+
| No PR delivery | Meet stage acceptance criteria and the selected mode's delivery requirements, without inventing PRs or unrelated approvals. |
|
|
36
|
+
| Final acceptance | Also meet the [acceptance requirements](final-acceptance.md) for the complete task or Goal. |
|
|
67
37
|
|
|
68
|
-
|
|
69
|
-
review
|
|
70
|
-
|
|
71
|
-
Keep the implementation or discussion plan in the session.
|
|
72
|
-
Requirements discussion defines the problem without architecture decisions or
|
|
73
|
-
production implementation. Solution discussion keeps its draft architecture and
|
|
74
|
-
breakdown in its owning task. Preserve the Goal's user-confirmation gates:
|
|
75
|
-
completed text, a review result, or successful checks cannot replace the user's
|
|
76
|
-
confirmation or authorize delivery. Keep an unconfirmed discussion in progress;
|
|
77
|
-
a material revision after confirmation needs renewed user confirmation.
|
|
38
|
+
Verify actual merges through the hosting platform's native client or API, without assuming a specific platform.
|
|
39
|
+
When the user requires PRs to remain open for review or prohibits merging, deliver reviewable results and keep the task in progress, without enabling auto-merge.
|
|
40
|
+
Completion remains pending when permission is missing, verification is impossible, or merge conditions are unmet.
|
|
78
41
|
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
references coherently. Preserve requirements; do not silently weaken acceptance.
|
|
82
|
-
Descriptions remain self-contained Markdown task summaries. Preserve valid
|
|
83
|
-
syntax, required task content, and actual resource references during full-field
|
|
84
|
-
updates; confirm new or replaced resources before linking them. Apply the content
|
|
85
|
-
boundary to authorized rewrites without modifying unrelated historical tasks.
|
|
86
|
-
Dependency edits
|
|
87
|
-
must follow the handbook's CLI replacement contract: read full D/E, retain needed
|
|
88
|
-
ordinary D−E and external E declarations, submit their intended complete sets
|
|
89
|
-
with the observed version, and read back both. Omit all dependency options for
|
|
90
|
-
unrelated metadata updates. Keep detailed task content and produced results at
|
|
91
|
-
their identified owners; shared inputs remain at their verified source.
|
|
42
|
+
Before returning to the mode-specific file for completion operations, confirm that required deliverables and acceptance conclusions are readable.
|
|
43
|
+
Completing a stage establishes only that stage's results, not completion of the whole Goal.
|
|
92
44
|
|
|
93
|
-
|
|
94
|
-
approval, or merge remains part of it. Keep all required delivery PR URLs and
|
|
95
|
-
titles in the complete `properties.pullRequests` list, preserving existing
|
|
96
|
-
entries. Save actual task results and acceptance conclusions at their owners.
|
|
97
|
-
Use verified artifact locations or immutable revisions when needed to identify
|
|
98
|
-
the final deliverable. Rewrite current results coherently rather than
|
|
99
|
-
accumulating an execution log. Keep operational authorization, implementation
|
|
100
|
-
steps, CI/review/merge handling, progress, blockers, waiting items, and next
|
|
101
|
-
action in the conversation or existing execution checkpoint, retaining the task
|
|
102
|
-
ID and needed PR and workspace references. Recover authorization and assignment
|
|
103
|
-
from that session context, not task material or status.
|
|
45
|
+
## Waiting context
|
|
104
46
|
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
add a PR-merge prerequisite to these Daynight discussions. If particular
|
|
110
|
-
repository artifacts or PR delivery are explicitly part of that discussion
|
|
111
|
-
task's acceptance, honor that requirement under its delivery rules.
|
|
112
|
-
Unconfirmed discussion material keeps its discussion task in progress.
|
|
113
|
-
|
|
114
|
-
Development tasks and design or documentation delivery tasks with PRs remain
|
|
115
|
-
in progress until the hosting platform confirms **every necessary delivery PR
|
|
116
|
-
is merged** and all stage acceptance criteria are satisfied. Code completion,
|
|
117
|
-
passing CI, approved review, and an open PR do not satisfy this condition. Verify
|
|
118
|
-
actual merge state through the host's native client or API; do not assume a
|
|
119
|
-
particular host.
|
|
120
|
-
|
|
121
|
-
Completion rules grant no merge, deployment, external communication, or mainline
|
|
122
|
-
push permission. Follow existing authorization without asking again for actions
|
|
123
|
-
it covers. If the user requests an open PR for review or forbids merging, deliver
|
|
124
|
-
the reviewable PR and preserve the waiting checkpoint. Do not enable auto-merge.
|
|
125
|
-
Missing permission, unavailable merge visibility, or an unmet merge check keeps
|
|
126
|
-
completion pending and successors blocked.
|
|
127
|
-
|
|
128
|
-
For tasks without a development or PR delivery path, use their stated stage
|
|
129
|
-
acceptance. For [final acceptance](../SKILL.md#final-acceptance), also apply the
|
|
130
|
-
shared whole-task or whole-Goal completion rule. In every case, confirm the
|
|
131
|
-
required deliverables and acceptance conclusions are readable before returning
|
|
132
|
-
to the execution mode's completion operation; retain operational verification
|
|
133
|
-
in the session. Discussion completion establishes that stage's accepted
|
|
134
|
-
output; it does not establish whole-Goal completion.
|
|
135
|
-
|
|
136
|
-
## Preserve waiting context
|
|
137
|
-
|
|
138
|
-
Continue CI and review waits as this task. When progress requires external
|
|
139
|
-
intervention, preserve the target, actual state, concrete blocker, existing work,
|
|
140
|
-
and next action in the checkpoint, then return the waiting result through the
|
|
141
|
-
selected execution mode. Do not declare completion or select other work to
|
|
142
|
-
bypass a wait. Preserve the task ID through recovery and waiting.
|
|
47
|
+
CI, review, and merge waits belong to the current task; the execution mode defines continued waiting, signaling, and return behavior.
|
|
48
|
+
When intervention is needed, preserve the task ID, actual status, existing work, specific blocker, PR and workspace references, existing authorization, and next step in the session checkpoint, not a task execution log.
|
|
49
|
+
Recover the assignment and authorization from this context, not by inferring them from task status.
|
|
50
|
+
Waiting neither completes the task nor permits selecting other work.
|