@erclx/aitk 0.50.0 → 0.51.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/claude/.claude-plugin/plugin.json +1 -1
- package/claude/skills/claude-orchestrate/REQUIREMENT.md +6 -1
- package/claude/skills/claude-orchestrate/SKILL.md +3 -3
- package/{snippets/claude → claude/skills/claude-orchestrate/references}/orchestrator-handoff.md +5 -0
- package/{snippets/claude → claude/skills/claude-orchestrate/references}/orchestrator-resume.md +5 -0
- package/{snippets/claude → claude/skills/claude-orchestrate/references}/orchestrator-sweep.md +5 -0
- package/package.json +1 -1
- package/snippets/snippets.toml +0 -7
|
@@ -15,6 +15,8 @@ The session also writes surfaces it is told only how to read. Refilling the queu
|
|
|
15
15
|
|
|
16
16
|
Output drifts everywhere the contract stops. The specified shape covers invocation alone, so a sweep report, a board report, and an analysis each end in a decision the human owns and each buries it under the evidence they would have skipped. A compaction is the same failure one step earlier, since the file that survives it has a stated reader and no stated writer, and the session improvises what to save and loses the reasoning the board never held.
|
|
17
17
|
|
|
18
|
+
The runbooks the session cannot run from memory fail on a third axis, which is where they are kept. A runbook reached by an installed path is a dependency on a channel this skill does not travel on, so a project holding the plugin and running no install follows the citation to nothing, and nothing reports the break because a missing file produces no error until someone opens the path. The three that cover the moments the loop cannot detect therefore have to ship inside the skill.
|
|
19
|
+
|
|
18
20
|
## Must
|
|
19
21
|
|
|
20
22
|
- Read the priority file for execution order, since the index sorts by filename and states no order
|
|
@@ -28,7 +30,9 @@ Output drifts everywhere the contract stops. The specified shape covers invocati
|
|
|
28
30
|
- Carry a plan pointer in the Plan column and a file set in the Touches column, so a row's readiness and disjointness claims stay checkable
|
|
29
31
|
- Re-resolve the board's plan pointers after any archive, since the archiving skill rewrites the task file and knows nothing about the board
|
|
30
32
|
- Lead a sweep report, a board report, and an analysis with the state, the open decisions, and the next action, keeping the evidence below them
|
|
31
|
-
- Write the pre-compact handoff with what no other file carries, and name the
|
|
33
|
+
- Write the pre-compact handoff with what no other file carries, and name the runbook that reads it back
|
|
34
|
+
- Carry the handoff, resume, and sweep runbooks inside the skill, so every citation resolves for a project holding the plugin and nothing else
|
|
35
|
+
- Read the handoff or the resume runbook when the human asks for that side of a compaction, since the request is the only signal available for a moment the loop cannot detect
|
|
32
36
|
|
|
33
37
|
## Must not
|
|
34
38
|
|
|
@@ -47,6 +51,7 @@ Output drifts everywhere the contract stops. The specified shape covers invocati
|
|
|
47
51
|
- Priority file absent: report the queue and say the order is unrecorded rather than inferring it from the index
|
|
48
52
|
- Roadmap absent: omit the roadmap line rather than asserting a version the file does not state
|
|
49
53
|
- Roadmap present but never committed: report the date as uncommitted, since a blank reads as a formatting slip
|
|
54
|
+
- This body dropped from a long session approaching a compaction: name the re-invocation and the runbook paths, since the routing lives in the body and a user-invoked skill routes nothing once it is gone
|
|
50
55
|
|
|
51
56
|
## Out of scope
|
|
52
57
|
|
|
@@ -35,9 +35,9 @@ Then output the state of play so the human knows what to launch, review, and mer
|
|
|
35
35
|
|
|
36
36
|
The roadmap is optional and this skill does not require it. It carries why a sequence is what it is, changes only when strategy changes, and is absent in a project whose scope has already shipped. Report what it says and name it as the source. Never assert an active version the file does not state, and say nothing about one when the file is missing.
|
|
37
37
|
|
|
38
|
-
A compaction is a moment this skill cannot detect, so
|
|
38
|
+
A compaction is a moment this skill cannot detect, so the human asks for each side of it and this skill reads the matching runbook when they do. On a request to write the handoff or save the session, read `${CLAUDE_SKILL_DIR}/references/orchestrator-handoff.md` and follow it. It writes `.claude/tasks/session.md` with the state of play, the decisions taken under delegated authority, the mistakes worth not repeating, and the standing cautions. On a request to resume after a compaction, read `${CLAUDE_SKILL_DIR}/references/orchestrator-resume.md`, which reads that file back with the board and the groundwork behind the live work. Write nothing to the handoff that the board, a task file, or a groundwork folder already carries.
|
|
39
39
|
|
|
40
|
-
|
|
40
|
+
That routing lives in this body and this skill is user-invoked, so a session that has dropped the body routes nothing and the request lands as ordinary conversation. Approaching a compaction is when a long session is likeliest to have dropped it, which is the same moment the handoff exists for. Re-invoke `/aitk:claude-orchestrate` first whenever the session has run long or the ask goes unanswered. The two runbooks sit at `references/orchestrator-handoff.md` and `references/orchestrator-resume.md` inside this skill's own folder, so a person who knows their plugin root opens either one directly and follows it without this skill loaded at all.
|
|
41
41
|
|
|
42
42
|
## Output
|
|
43
43
|
|
|
@@ -110,7 +110,7 @@ Write no shape for a correction. A correction is a sentence, and a format for ad
|
|
|
110
110
|
|
|
111
111
|
## Refilling the ready queue
|
|
112
112
|
|
|
113
|
-
Keep enough planned, non-conflicting tasks available that a free worker never waits, and place the findings the last merge produced before promoting anything new. Run this after every merge and whenever the ready list thins.
|
|
113
|
+
Keep enough planned, non-conflicting tasks available that a free worker never waits, and place the findings the last merge produced before promoting anything new. Run this after every merge and whenever the ready list thins. `${CLAUDE_SKILL_DIR}/references/orchestrator-sweep.md` wraps this procedure for a batch of merges and adds the plan re-verification that a merge invalidates.
|
|
114
114
|
|
|
115
115
|
Open the sweep by invoking `aitk:claude-memory-capture`. Both other callers are ship-chain skills and this session never ships, so without this the session that receives every operator correction is the one session that records none. The sweep is the closest bounded moment this session has to a ship, and it already runs once per batch of merges, which beats an end-of-session moment a compaction can cut short.
|
|
116
116
|
|
package/{snippets/claude → claude/skills/claude-orchestrate/references}/orchestrator-handoff.md
RENAMED
|
@@ -1,3 +1,8 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Orchestrator handoff runbook
|
|
3
|
+
description: What to write to .claude/tasks/session.md before a compaction, and what to leave to the board
|
|
4
|
+
---
|
|
5
|
+
|
|
1
6
|
Write the pre-compact handoff as orchestrator. Do this before a compaction, because a compaction keeps conclusions and drops the reasoning that produced them, and no other file in the repository carries that reasoning.
|
|
2
7
|
|
|
3
8
|
1. Resolve the main worktree root with `git worktree list --porcelain | grep -m 1 '^worktree ' | cut -d' ' -f2-`, falling back to `pwd`. Write `.claude/tasks/session.md` under it.
|
package/{snippets/claude → claude/skills/claude-orchestrate/references}/orchestrator-resume.md
RENAMED
|
@@ -1,3 +1,8 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Orchestrator resume runbook
|
|
3
|
+
description: What to read back after a compaction, and how to treat a groundwork folder's three shelf lives
|
|
4
|
+
---
|
|
5
|
+
|
|
1
6
|
Resume as orchestrator after a compaction. Read the board and the groundwork behind the live work before answering anything, because a compaction summary keeps conclusions and drops the reasoning that produced them.
|
|
2
7
|
|
|
3
8
|
1. Resolve the main worktree root with `git worktree list --porcelain | grep -m 1 '^worktree ' | cut -d' ' -f2-`, falling back to `pwd`. Every path below resolves against it.
|
package/{snippets/claude → claude/skills/claude-orchestrate/references}/orchestrator-sweep.md
RENAMED
|
@@ -1,3 +1,8 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Orchestrator sweep runbook
|
|
3
|
+
description: The once-per-batch board sweep, plan re-verification, and where each merged finding goes
|
|
4
|
+
---
|
|
5
|
+
|
|
1
6
|
Sweep the board as orchestrator after merging. Run this once per batch of merges, before answering what to do next, because the surfaces that record what shipped are the ones nothing updates on its own.
|
|
2
7
|
|
|
3
8
|
1. Pull into the main worktree rather than fetching. A fetch leaves the local branch behind, so `git log` reports a state that has not arrived. A repository that adds a post-merge hook to name archive candidates gets it on a pull and never on a fetch.
|
package/package.json
CHANGED