yaojingang
63 lines
3.0 KiB
Markdown
63 lines
3.0 KiB
Markdown
# Iteration Directions
|
|
|
|
Skill: `yao-meta-skill`
|
|
|
|
- Maturity tier: `governed`
|
|
- Selection rule: Pick the three smallest next steps that increase reliability more than they increase context cost.
|
|
- Start here: `Borrow one proven pattern on purpose`
|
|
- Why first: You already have public benchmark objects. The next gain is to choose one pattern intentionally instead of absorbing everything loosely.
|
|
- Defer for now: `Create an iteration evidence loop`
|
|
|
|
## Top 3 Next Moves
|
|
|
|
### 2. Borrow one proven pattern on purpose
|
|
|
|
- Why now: You already have public benchmark objects. The next gain is to choose one pattern intentionally instead of absorbing everything loosely.
|
|
- Timing: Do this first.
|
|
- Recommended actions:
|
|
- Read the strongest pattern from obra/superpowers.
|
|
- Unlocks: A cleaner package shape with less accidental over-design.
|
|
- Wait on: Wait to add broader structure until this move clearly improves reliability.
|
|
|
|
- Decide whether to borrow method, structure, execution, or portability, but only one of them first.
|
|
- Unlocks: A cleaner package shape with less accidental over-design.
|
|
- Wait on: Wait to add broader structure until this move clearly improves reliability.
|
|
|
|
- Record what you will not borrow so the package stays light.
|
|
- Unlocks: A cleaner package shape with less accidental over-design.
|
|
- Wait on: Wait to add broader structure until this move clearly improves reliability.
|
|
|
|
### 5. Harden portability semantics
|
|
|
|
- Why now: The skill already signals reuse across environments, so contract clarity matters early.
|
|
- Timing: Do this after the first move lands cleanly.
|
|
- Recommended actions:
|
|
- Confirm activation mode, execution context, and trust assumptions.
|
|
- Unlocks: Safer cross-environment reuse with less target drift.
|
|
- Wait on: Wait until the package has evidence that this extra structure is justified.
|
|
|
|
- Add or review degradation strategy for non-native targets.
|
|
- Unlocks: Safer cross-environment reuse with less target drift.
|
|
- Wait on: Wait until the package has evidence that this extra structure is justified.
|
|
|
|
- Package the skill once to verify adapter expectations.
|
|
- Unlocks: Safer cross-environment reuse with less target drift.
|
|
- Wait on: Wait until the package has evidence that this extra structure is justified.
|
|
|
|
### 12. Create an iteration evidence loop
|
|
|
|
- Why now: The package should show what changed and why after the first draft.
|
|
- Timing: Do this after the first move lands cleanly.
|
|
- Recommended actions:
|
|
- Generate the HTML skill report and keep it aligned with the package.
|
|
- Unlocks: A clearer path for the next author or reviewer.
|
|
- Wait on: Wait until the package has evidence that this extra structure is justified.
|
|
|
|
- Record reference scan choices and non-goals.
|
|
- Unlocks: A clearer path for the next author or reviewer.
|
|
- Wait on: Wait until the package has evidence that this extra structure is justified.
|
|
|
|
- Capture the next iteration choice explicitly before adding more files.
|
|
- Unlocks: A clearer path for the next author or reviewer.
|
|
- Wait on: Wait until the package has evidence that this extra structure is justified.
|