Reflect
Contract
| Field |
Bound contract |
| Trigger |
Reflect on a completed task to improve invoked skills. |
| Authority |
Human-gated: explicit invocation required before any mutation; every other write is reversible local, with version control as the rollback. |
| Side effect |
Edits approved skills and may file backlog items. |
| Done |
Approved improvements applied and rejections explained. |
Refusals
- Edits without explicit human approval: rejected. Every "apply now" or "apply on approval" proposal requires explicit human sign-off before any file change.
- Analysis beyond the named skills: rejected. Do not widen the analysis beyond the invoked skills the human supplied.
- Remote, credential, publish, deploy, or irreversible changes: rejected.
Inputs
The human must supply:
- The completed task context (what was attempted, what happened, what remains).
- The list of invoked skill slugs or names.
Optional: evidence of failure patterns, specific lines or sections to target, or scope constraints.
Procedure
- Collect context. Gather the task context and the list of invoked skills from the human. Identify which skill files are reachable in the workspace. Done when: the task context and skill list are gathered and reachable files are identified.
- Analyze. Examine the invoked skills for failure patterns, missing coverage, unclear scope, or improvement opportunities. Do not widen the analysis beyond the named skills. Done when: each skill has been examined and findings are listed.
- Propose. Present each finding as a discrete improvement proposal. Label each as "apply now", "apply on approval", or "backlog item". Keep proposals scoped to one skill. Done when: every finding is presented as a labeled proposal.
- Get approval. For every "apply now" or "apply on approval" proposal, obtain explicit human approval before making any file change. Done when: every proposal has an approval decision recorded.
- Execute. Apply approved edits to the skill files. File any approved backlog items. Report every applied change and every rejected or deferred proposal. Done when: all approved edits are applied and all rejections are recorded.
Failure and recovery
- Analysis failure: if the skill files cannot be read or the task context is insufficient, stop and report the reason.
- No improvement found: state that finding and end without mutation.
- Approval withheld: record the reason and continue with remaining proposals.
- Application failure: if an approved edit cannot be applied after human sign-off, attempt to roll back any partial change and report the blocked state. Do not declare success when the done predicate does not hold.
Output
A reflection report with each analyzed skill and findings, each approved change and its result, each rejected or deferred proposal and the reason, and any filed backlog items, ordered as listed, ending with a statement that the done predicate holds or the specific outstanding block.
1---2name: reflect-93description: Use when a completed task needs reflection on invoked skills to propose and apply approved improvements. Not for remote, credential, publish, deploy, or irreversible changes.4---5
6# Reflect
7
8## Contract
9
10| Field | Bound contract |
11|---|---|
12| Trigger | Reflect on a completed task to improve invoked skills. |
13| Authority | Human-gated: explicit invocation required before any mutation; every other write is reversible local, with version control as the rollback. |
14| Side effect | Edits approved skills and may file backlog items. |
15| Done | Approved improvements applied and rejections explained. |
16
17## Refusals
18
19- Edits without explicit human approval: rejected. Every "apply now" or "apply on approval" proposal requires explicit human sign-off before any file change.
20- Analysis beyond the named skills: rejected. Do not widen the analysis beyond the invoked skills the human supplied.
21- **Remote, credential, publish, deploy, or irreversible changes**: rejected.
22
23## Inputs
24
25The human must supply:
26- The completed task context (what was attempted, what happened, what remains).
27- The list of invoked skill slugs or names.
28
29Optional: evidence of failure patterns, specific lines or sections to target, or scope constraints.
30
31## Procedure
32
331. Collect context. Gather the task context and the list of invoked skills from the human. Identify which skill files are reachable in the workspace. **Done when**: the task context and skill list are gathered and reachable files are identified.
342. Analyze. Examine the invoked skills for failure patterns, missing coverage, unclear scope, or improvement opportunities. Do not widen the analysis beyond the named skills. **Done when**: each skill has been examined and findings are listed.
353. Propose. Present each finding as a discrete improvement proposal. Label each as "apply now", "apply on approval", or "backlog item". Keep proposals scoped to one skill. **Done when**: every finding is presented as a labeled proposal.
364. Get approval. For every "apply now" or "apply on approval" proposal, obtain explicit human approval before making any file change. **Done when**: every proposal has an approval decision recorded.
375. Execute. Apply approved edits to the skill files. File any approved backlog items. Report every applied change and every rejected or deferred proposal. **Done when**: all approved edits are applied and all rejections are recorded.
38
39## Failure and recovery
40
41- Analysis failure: if the skill files cannot be read or the task context is insufficient, stop and report the reason.
42- No improvement found: state that finding and end without mutation.
43- Approval withheld: record the reason and continue with remaining proposals.
44- Application failure: if an approved edit cannot be applied after human sign-off, attempt to roll back any partial change and report the blocked state. Do not declare success when the done predicate does not hold.
45
46## Output
47
48A reflection report with each analyzed skill and findings, each approved change and its result, each rejected or deferred proposal and the reason, and any filed backlog items, ordered as listed, ending with a statement that the done predicate holds or the specific outstanding block.
majiayu000