Skip to content

Commit 7fd57d7

Browse files
committed
config: Finalize workflow language consistency
1 parent 83790e6 commit 7fd57d7

37 files changed

Lines changed: 216 additions & 135 deletions

File tree

‎.agents/skills/sce-change-to-plan/references/output.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,7 @@ This is chat output, not a file. Nothing here is written to the plan.
6666

6767
## Layout
6868

69-
```
69+
```markdown
7070
# Plan: {plan.name}
7171

7272
Path: {plan.path}
@@ -108,14 +108,14 @@ explicit `None.` confirms nothing is pending.
108108

109109
When `assumptions` is empty:
110110

111-
```
111+
```markdown
112112
## Assumptions
113113
- None.
114114
```
115115

116116
When `open_questions` is absent:
117117

118-
```
118+
```markdown
119119
## Open questions
120120
- None.
121121
```
@@ -132,7 +132,7 @@ When `open_questions` is absent:
132132

133133
## Example
134134

135-
```
135+
```markdown
136136
# Plan: red-sce-banner
137137

138138
Path: context/plans/red-sce-banner.md

‎.agents/skills/sce-change-to-plan/references/plan-authoring.md‎

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -13,11 +13,10 @@ This phase owns the planning process:
1313
- Decide task boundaries, dependencies, and ordering.
1414
- Write or revise exactly one `context/plans/{plan_name}.md`.
1515

16-
`references/plan-template.md` is the sole owner of the persisted plan schema and
17-
generic document-authoring rules: acceptance-criteria format and validation
18-
semantics, task fields and atomic slicing, the no-validation-task rule, completion
19-
records, and existing-plan update preservation. Read it before authoring or
20-
revising and apply those rules rather than restating them here.
16+
`references/plan-template.md` is the sole owner of the persisted plan schema.
17+
Read its `Acceptance criteria rules`, `Task rules` and `No validation task` rules,
18+
and `Updating an existing plan` rules before authoring or revising. Apply those
19+
rules rather than restating them here.
2120

2221
The workflow renders this phase's result as the summary defined in
2322
`references/output.md`.
@@ -162,8 +161,7 @@ semantics and placement.
162161

163162
Slice and order the plan-specific work after the acceptance criteria, applying the
164163
`Task rules` and `No validation task` rules in `references/plan-template.md`.
165-
The template owns the task field shape, atomic-commit constraint, dependency-order
166-
rule, acceptance-coverage rule, and generic task exclusions.
164+
Do not restate those generic task rules here.
167165

168166
A finished stack always leaves at least one incomplete task, so the workflow can
169167
always hand off to `/next-task`. When the request resolves to a plan but produces

‎.agents/skills/sce-decision/SKILL.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ description: >
1010

1111
Write exactly one architecture decision record for one decision already qualified
1212
by successful task context synchronization. Return a deterministic internal
13-
handoff to the invoking synchronization phase. Do not render an independent
13+
result to the invoking synchronization phase. Do not render an independent
1414
user-visible response.
1515

1616
## Input
@@ -25,7 +25,7 @@ synchronization. It must identify:
2525
- Related current-state context and existing ADR paths.
2626
- An optional requested status.
2727

28-
Do not accept raw workflow arguments, ordinary phase state, multiple decisions,
28+
Do not accept raw workflow arguments, ordinary phase result, multiple decisions,
2929
or direct user invocation. Do not reconstruct missing material facts.
3030

3131
## Qualification handoff
@@ -101,9 +101,9 @@ the filename, status, sections, and references satisfy this contract; every
101101
referenced repository path exists when practical to check; and no accepted ADR
102102
was modified.
103103

104-
### 6. Return internal state
104+
### 6. Return the result
105105

106-
Return exactly one internal handoff:
106+
Return exactly one internal result:
107107

108108
- `written`: include `status`, `adr_path`, `decision`, `decision_status`,
109109
`created` (`true` for a new ADR and `false` for reuse), `supersedes`, and
@@ -115,7 +115,7 @@ Return exactly one internal handoff:
115115
`required_action`. Use this only when decision writing cannot proceed safely.
116116

117117
Use stable field names and repository-relative paths. Return no prose before or
118-
after the handoff. The invoking synchronization phase owns all user-visible
118+
after the result. The invoking synchronization phase owns all user-visible
119119
reporting.
120120

121121
## Boundaries

‎.agents/skills/sce-next-task/references/context-sync.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,8 @@ Run this phase for step 3 of the workflow, and only when task execution returned
55
session inherits what this task established. It never touches code, tests, or
66
plan state.
77

8-
Input: either the complete `complete` result from the task execution phase
9-
(same-session), passed verbatim, or the plan path and task ID a plan-review
8+
Input: either the task execution result with `status: complete`
9+
(same-session), passed unchanged, or the plan path and task ID a plan-review
1010
recovery step resolved for a completed task with unresolved context synchronization, together with that task's own
1111
completed record — read directly from the plan — and its persisted `Context
1212
synchronization blocker` when present (cross-session retry). Whichever was
@@ -331,4 +331,4 @@ Do not:
331331
except `sce-decision`, or invoke `sce-decision` outside the decision gate in
332332
successful context synchronization.
333333
- Delete a context file that has uncommitted changes.
334-
- Return an execution-style internal state.
334+
- Return a task-execution internal result.

‎.agents/skills/sce-next-task/references/output.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ be synchronized before continuing.
4848

4949
{completed-tasks} of {total-tasks} tasks complete.
5050

51-
Next up:
51+
Next step:
5252

5353
{next-task-id} — {next-task-title}
5454

‎.agents/skills/sce-next-task/references/plan-review.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -109,14 +109,14 @@ Set internal status `blocked` when a missing decision materially affects:
109109

110110
## 1.5 Return the result
111111

112-
Set exactly one internal state:
112+
Return one internal result with one of these statuses:
113113

114114
- `ready`
115115
- `blocked`
116116
- `plan_complete`
117117
- `sync_debt`
118118

119-
Record only the internal state. Do not add explanatory prose before or after it.
119+
Return only the internal result. Do not add explanatory prose before or after it.
120120

121121
A `ready` result must identify:
122122

‎.agents/skills/sce-next-task/references/task-execution.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -194,11 +194,11 @@ that decision after context synchronization.
194194
Before returning a `complete` result, verify that it satisfies the authoritative
195195
handoff contract above.
196196

197-
## 2.9 Return internal state
197+
## 2.9 Return the result
198198

199-
After the phase reaches a terminal state, set exactly one internal state.
199+
After the phase reaches a terminal state, return exactly one internal result.
200200

201-
Record only the internal state. Do not add explanatory prose before or after it.
201+
Return only the internal result. Do not add explanatory prose before or after it.
202202

203203
A `complete` result is the authoritative handoff into step 3. Pass it unchanged;
204204
step 3 must consume it instead of reconstructing its fields.

‎.agents/skills/sce-validate/references/validation-report.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,6 @@ After repairs, rerun:
6767
- When status is `failed`, always include **Retry** with the exact
6868
`/validate {plan path}` command. Omit **Retry** when status is `validated`.
6969
- Keep evidence concise and factual. Do not narrate the whole implementation
70-
history or add execution-policy claims absent from the validation result.
70+
history or add execution-policy claims absent from the validation report.
7171
- When a previous `## Validation Report` already exists, replace it with the new
7272
one rather than stacking duplicates.

‎.agents/skills/sce-validate/references/validation.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,11 +14,11 @@ This phase owns:
1414
check.
1515
- Writing the Validation Report into the plan.
1616
- Marking acceptance criteria against the evidence.
17-
- Returning one Markdown validation result.
17+
- Returning one Markdown validation report.
1818

1919
Return a result matching:
2020

21-
the **Validation Result** section below in this file
21+
the **Validation report** section below in this file
2222

2323
Write plan-file evidence matching:
2424

@@ -109,7 +109,7 @@ Return exactly one Markdown report:
109109
passed, and the Validation Report was written.
110110
- `failed` when evidence was captured but required checks or criteria remain
111111
unsatisfied. Shape it as a session handoff per
112-
the **Validation Result** section below in this file, ending recommended work with
112+
the **Validation report** section below in this file, ending recommended work with
113113
`/validate {plan path}`.
114114
- `blocked` when validation cannot proceed safely.
115115

@@ -140,7 +140,7 @@ The phase is complete after:
140140
- One plan was resolved, or resolution failed and was reported.
141141
- Implementation completeness was checked.
142142
- Validation ran to a terminal state, or a blocker prevented it.
143-
- One valid Markdown report matching the **Validation Result** section below in this file was
143+
- One valid Markdown report matching the **Validation report** section below in this file was
144144
returned.
145145

146146

‎.claude/skills/sce-change-to-plan/references/output.md‎

Lines changed: 4 additions & 4 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)