@ikon85/agent-workflow-kit 0.34.6 → 0.35.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/.agents/skills/ask-matt/SKILL.md +8 -0
- package/.agents/skills/audit-skills/SKILL.md +8 -0
- package/.agents/skills/board-to-waves/SKILL.md +8 -0
- package/.agents/skills/census-update/SKILL.md +8 -0
- package/.agents/skills/code-review/SKILL.md +8 -0
- package/.agents/skills/codebase-design/SKILL.md +8 -0
- package/.agents/skills/codex-adapter-sync/SKILL.md +8 -0
- package/.agents/skills/decision-gate/SKILL.md +8 -0
- package/.agents/skills/diagnose/SKILL.md +8 -0
- package/.agents/skills/domain-modeling/SKILL.md +8 -0
- package/.agents/skills/git-worktree-recover/SKILL.md +8 -0
- package/.agents/skills/grill-me/SKILL.md +8 -0
- package/.agents/skills/grill-with-docs/SKILL.md +8 -0
- package/.agents/skills/implement/SKILL.md +8 -0
- package/.agents/skills/improve-codebase-architecture/SKILL.md +8 -0
- package/.agents/skills/kit-release/SKILL.md +8 -0
- package/.agents/skills/kit-update/SKILL.md +18 -4
- package/.agents/skills/local-ci/SKILL.md +8 -0
- package/.agents/skills/memory-lifecycle/SKILL.md +8 -0
- package/.agents/skills/orchestrate-wave/SKILL.md +2 -2
- package/.agents/skills/project-release/SKILL.md +8 -0
- package/.agents/skills/prototype/SKILL.md +8 -0
- package/.agents/skills/research/SKILL.md +8 -0
- package/.agents/skills/resolving-merge-conflicts/SKILL.md +8 -0
- package/.agents/skills/retro/SKILL.md +8 -0
- package/.agents/skills/scale-check/SKILL.md +8 -0
- package/.agents/skills/security-audit/SKILL.md +8 -0
- package/.agents/skills/setup-workflow/SKILL.md +30 -0
- package/.agents/skills/setup-workflow/orchestrate-wave-seed.md +1 -0
- package/.agents/skills/setup-workflow/spec-self-critique-seed.md +1 -0
- package/.agents/skills/spec-self-critique/SKILL.md +8 -0
- package/.agents/skills/tdd/SKILL.md +8 -0
- package/.agents/skills/to-issues/SKILL.md +8 -0
- package/.agents/skills/to-prd/SKILL.md +8 -0
- package/.agents/skills/to-waves/SKILL.md +8 -0
- package/.agents/skills/triage/SKILL.md +8 -0
- package/.agents/skills/verify-spike/SKILL.md +8 -0
- package/.agents/skills/wayfinder/SKILL.md +8 -0
- package/.agents/skills/wrapup/SKILL.md +8 -0
- package/.claude/skills/ask-matt/SKILL.md +8 -0
- package/.claude/skills/audit-skills/SKILL.md +8 -0
- package/.claude/skills/board-to-waves/SKILL.md +8 -0
- package/.claude/skills/census-update/SKILL.md +8 -0
- package/.claude/skills/code-review/SKILL.md +8 -0
- package/.claude/skills/codebase-design/SKILL.md +8 -0
- package/.claude/skills/codex-build/SKILL.md +8 -0
- package/.claude/skills/codex-review/SKILL.md +8 -0
- package/.claude/skills/decision-gate/SKILL.md +8 -0
- package/.claude/skills/diagnose/SKILL.md +8 -0
- package/.claude/skills/domain-modeling/SKILL.md +8 -0
- package/.claude/skills/git-guardrails-claude-code/SKILL.md +8 -0
- package/.claude/skills/git-worktree-recover/SKILL.md +8 -0
- package/.claude/skills/grill-me/SKILL.md +8 -0
- package/.claude/skills/grill-me-codex/SKILL.md +8 -0
- package/.claude/skills/grill-with-docs/SKILL.md +8 -0
- package/.claude/skills/grill-with-docs-codex/SKILL.md +8 -0
- package/.claude/skills/implement/SKILL.md +8 -0
- package/.claude/skills/improve-codebase-architecture/SKILL.md +8 -0
- package/.claude/skills/kit-release/SKILL.md +8 -0
- package/.claude/skills/kit-update/SKILL.md +18 -4
- package/.claude/skills/local-ci/SKILL.md +8 -0
- package/.claude/skills/memory-lifecycle/SKILL.md +8 -0
- package/.claude/skills/orchestrate-wave/SKILL.md +2 -2
- package/.claude/skills/project-release/SKILL.md +8 -0
- package/.claude/skills/prototype/SKILL.md +8 -0
- package/.claude/skills/research/SKILL.md +8 -0
- package/.claude/skills/resolving-merge-conflicts/SKILL.md +8 -0
- package/.claude/skills/retro/SKILL.md +8 -0
- package/.claude/skills/scale-check/SKILL.md +8 -0
- package/.claude/skills/security-audit/SKILL.md +8 -0
- package/.claude/skills/setup-pre-commit/SKILL.md +8 -0
- package/.claude/skills/setup-workflow/SKILL.md +30 -0
- package/.claude/skills/setup-workflow/orchestrate-wave-seed.md +1 -0
- package/.claude/skills/setup-workflow/spec-self-critique-seed.md +1 -0
- package/.claude/skills/spec-self-critique/SKILL.md +8 -0
- package/.claude/skills/tdd/SKILL.md +8 -0
- package/.claude/skills/to-issues/SKILL.md +8 -0
- package/.claude/skills/to-prd/SKILL.md +8 -0
- package/.claude/skills/to-waves/SKILL.md +8 -0
- package/.claude/skills/triage/SKILL.md +8 -0
- package/.claude/skills/verify-spike/SKILL.md +8 -0
- package/.claude/skills/wayfinder/SKILL.md +8 -0
- package/.claude/skills/wrapup/SKILL.md +8 -0
- package/.claude/skills/write-a-skill/SKILL.md +8 -0
- package/README.md +118 -4
- package/agent-workflow-kit.package.json +127 -87
- package/docs/agents/skills/local-ci.md +1 -0
- package/docs/agents/skills/orchestrate-wave.md +1 -1
- package/docs/agents/skills/spec-self-critique.md +1 -1
- package/package.json +1 -1
- package/scripts/project-skill-extension.mjs +37 -0
- package/scripts/readiness.mjs +2 -1
- package/scripts/test_skill_publish_audit.py +9 -1
- package/src/cli.mjs +29 -12
- package/src/commands/init.mjs +24 -0
- package/src/commands/own.mjs +4 -3
- package/src/commands/update.mjs +86 -21
- package/src/lib/bundle.mjs +5 -0
- package/src/lib/manifest.mjs +13 -2
- package/src/lib/ownershipClassifier.mjs +54 -0
- package/src/lib/projectSkillExtension.mjs +60 -0
- package/src/lib/skillRegistry.mjs +167 -0
- package/src/lib/updateCandidate.mjs +105 -4
- package/src/lib/updateDecisions.mjs +5 -0
- package/src/lib/updateReconcile.mjs +64 -8
- package/src/lib/verifyUpdateCandidate.mjs +13 -1
- package/src/lib/verifyUpdateCandidateProtocol.mjs +2 -0
- package/src/lib/verifyUpdateCandidateTransaction.mjs +9 -3
|
@@ -3,6 +3,14 @@ name: setup-pre-commit
|
|
|
3
3
|
description: Set up a native, zero-dependency git pre-commit hook (via core.hooksPath) that runs your project's type checks, linting, tests, or formatting before each commit. Use when the user wants to add pre-commit hooks, gate commits on checks, or wire commit-time typecheck/lint/test/format — no Husky or Node deps required.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
+
<!-- project-extension:protocol-v1:start -->
|
|
7
|
+
## Project extension
|
|
8
|
+
|
|
9
|
+
Before applying this Core skill, run `node scripts/project-skill-extension.mjs inspect --skill setup-pre-commit --json` from the Project root. When it returns `active`, read the returned `path` and apply it as additive Project instructions. When it returns `inactive`, continue with Core only. When it returns `blocked`, stop and report its diagnostic.
|
|
10
|
+
|
|
11
|
+
Project extensions may specialize Project details, but cannot weaken Core user gates, safety, ownership, or validation. A contradiction blocks and requires an Explicit fork.
|
|
12
|
+
<!-- project-extension:protocol-v1:end -->
|
|
13
|
+
|
|
6
14
|
# Setup Pre-Commit Hooks (native git, zero-dep)
|
|
7
15
|
|
|
8
16
|
## What This Sets Up
|
|
@@ -4,6 +4,14 @@ description: "Scaffolds the project layer the portable workflow skills assume
|
|
|
4
4
|
disable-model-invocation: true
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
+
<!-- project-extension:protocol-v1:start -->
|
|
8
|
+
## Project extension
|
|
9
|
+
|
|
10
|
+
Before applying this Core skill, run `node scripts/project-skill-extension.mjs inspect --skill setup-workflow --json` from the Project root. When it returns `active`, read the returned `path` and apply it as additive Project instructions. When it returns `inactive`, continue with Core only. When it returns `blocked`, stop and report its diagnostic.
|
|
11
|
+
|
|
12
|
+
Project extensions may specialize Project details, but cannot weaken Core user gates, safety, ownership, or validation. A contradiction blocks and requires an Explicit fork.
|
|
13
|
+
<!-- project-extension:protocol-v1:end -->
|
|
14
|
+
|
|
7
15
|
# Setup Workflow
|
|
8
16
|
|
|
9
17
|
Scaffold the **project layer** the portable workflow skills (`to-prd`, `to-issues`, `triage`, `spec-self-critique`, `retro`, `wrapup`, …) read at runtime. The generic skills ship the *how*; this skill writes the project-specific *what* into the consumer repo, where `retro`/`wrapup` then grow it over time.
|
|
@@ -48,6 +56,28 @@ Every project-layer file this skill (or `npx init`) creates begins with **one se
|
|
|
48
56
|
- **CLAUDE.md / AGENTS.md carry no sentinel** (they are not ours) → reconcile **per section** via the block headers `## Workflow` / `## Agent skills` / `## Prod`: add a missing block, never overwrite an existing one or surrounding user content.
|
|
49
57
|
- **Never overwrite filled content.** A re-run only fills what is missing/stub. End with a report: `<file>: created · filled · skipped (already filled / legacy / not-applicable)`.
|
|
50
58
|
|
|
59
|
+
## Universal Project skill extensions
|
|
60
|
+
|
|
61
|
+
Every shipped skill can consume an additive Project extension at
|
|
62
|
+
`docs/agents/skills/<skill>.md`. A newly created extension starts with this
|
|
63
|
+
identity and schema marker (after the optional setup-workflow sentinel):
|
|
64
|
+
|
|
65
|
+
```md
|
|
66
|
+
<!-- agent-workflow-kit: project-extension/v1; skill=<skill> -->
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
The marker's `<skill>` must match the filename and a canonical or locally
|
|
70
|
+
registered skill identity. Existing non-empty files without a marker remain
|
|
71
|
+
supported as legacy v0 and are never rewritten merely to add the marker.
|
|
72
|
+
Setup and update preserve every extension byte-for-byte unless a future,
|
|
73
|
+
declared schema migration explicitly includes it.
|
|
74
|
+
|
|
75
|
+
Use an extension for Project language, commands, policy, and capability data
|
|
76
|
+
that the Core skill already knows how to apply. It is additive and cannot
|
|
77
|
+
weaken Core user gates, safety, ownership, or validation. Changes to parsing,
|
|
78
|
+
migration, evaluation, or other executable Core semantics require an
|
|
79
|
+
Explicit fork with a separate identity and update line.
|
|
80
|
+
|
|
51
81
|
## Process
|
|
52
82
|
|
|
53
83
|
### 1. Explore
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
<!-- agent-workflow-kit: project-extension/v1; skill=spec-self-critique -->
|
|
1
2
|
# Project layer — spec-self-critique
|
|
2
3
|
|
|
3
4
|
The generic `spec-self-critique` skill ships the 12-point checklist (the check *intents* + the structure). This file is the **project layer**: it enriches each point with project-specific incidents, grep patterns, conventions, and extra sub-checks. The skill reads it at runtime; with this file present it runs the full pass instead of warning that the layer is absent.
|
|
@@ -3,6 +3,14 @@ name: spec-self-critique
|
|
|
3
3
|
description: "Use AFTER writing or editing a spec (a `SPEC.md`/`PLAN.md` or any spec/design doc), BEFORE asking the user to review — runs a 12-point structural Self-Critique checklist, fixes issues inline, and emits a visible summary. Enriches each check from a project layer if one is present. Triggers right after a spec has been written. NOT for reviewing finished code/diffs (code-review) — this pass runs on the spec text itself."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
+
<!-- project-extension:protocol-v1:start -->
|
|
7
|
+
## Project extension
|
|
8
|
+
|
|
9
|
+
Before applying this Core skill, run `node scripts/project-skill-extension.mjs inspect --skill spec-self-critique --json` from the Project root. When it returns `active`, read the returned `path` and apply it as additive Project instructions. When it returns `inactive`, continue with Core only. When it returns `blocked`, stop and report its diagnostic.
|
|
10
|
+
|
|
11
|
+
Project extensions may specialize Project details, but cannot weaken Core user gates, safety, ownership, or validation. A contradiction blocks and requires an Explicit fork.
|
|
12
|
+
<!-- project-extension:protocol-v1:end -->
|
|
13
|
+
|
|
6
14
|
# Spec Self-Critique
|
|
7
15
|
|
|
8
16
|
A portable, structural self-review pass over a freshly written spec/plan. The **generic 12-point skeleton** below ships as-is; a **project layer** (if present) enriches each point with project-specific incidents, grep patterns, conventions, and extra sub-checks.
|
|
@@ -3,6 +3,14 @@ name: tdd
|
|
|
3
3
|
description: Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
+
<!-- project-extension:protocol-v1:start -->
|
|
7
|
+
## Project extension
|
|
8
|
+
|
|
9
|
+
Before applying this Core skill, run `node scripts/project-skill-extension.mjs inspect --skill tdd --json` from the Project root. When it returns `active`, read the returned `path` and apply it as additive Project instructions. When it returns `inactive`, continue with Core only. When it returns `blocked`, stop and report its diagnostic.
|
|
10
|
+
|
|
11
|
+
Project extensions may specialize Project details, but cannot weaken Core user gates, safety, ownership, or validation. A contradiction blocks and requires an Explicit fork.
|
|
12
|
+
<!-- project-extension:protocol-v1:end -->
|
|
13
|
+
|
|
6
14
|
# Test-Driven Development
|
|
7
15
|
|
|
8
16
|
## Philosophy
|
|
@@ -3,6 +3,14 @@ name: to-issues
|
|
|
3
3
|
description: Break a Feature or Program plan, spec, or PRD into independently-grabbable issues on the project issue tracker. This is the single public Planning facade: explicit Feature identity uses tracer-bullet decomposition; explicit Program identity delegates to the internal graph engine.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
+
<!-- project-extension:protocol-v1:start -->
|
|
7
|
+
## Project extension
|
|
8
|
+
|
|
9
|
+
Before applying this Core skill, run `node scripts/project-skill-extension.mjs inspect --skill to-issues --json` from the Project root. When it returns `active`, read the returned `path` and apply it as additive Project instructions. When it returns `inactive`, continue with Core only. When it returns `blocked`, stop and report its diagnostic.
|
|
10
|
+
|
|
11
|
+
Project extensions may specialize Project details, but cannot weaken Core user gates, safety, ownership, or validation. A contradiction blocks and requires an Explicit fork.
|
|
12
|
+
<!-- project-extension:protocol-v1:end -->
|
|
13
|
+
|
|
6
14
|
# To Issues
|
|
7
15
|
|
|
8
16
|
> **Skill identity (don't get confused):** the folder `to-issues` + invocation `/to-issues` map to Matt Pocock's upstream skill **`to-tickets`**. Upstream merged `to-issues` + the short-lived `to-plan` into `to-tickets` (v1.1.0); we deliberately keep the folder name `to-issues` (invocation stability, and issues are this workflow's vocabulary). Content remains our fork, compared against upstream `to-tickets` @ `d574778`. Provenance/rename ledger: `docs/agents/provenance.md` (§Re-Sync-Log), at the project root.
|
|
@@ -4,6 +4,14 @@ disable-model-invocation: true
|
|
|
4
4
|
description: "Turn a locked plan (PLAN.md in the worktree, conversation context, or an externally-authored spec) into a Draft-PRD issue on the project board, then run spec-self-critique. Use after a grill (grill-me / grill-with-docs / their -codex variants) when you want to publish the PRD. Three modes — create fresh, reuse an existing cluster/Wave-less issue, or auto-detect a Program-PRD from a plan's Wellenplan chapter. Does NOT decompose into slices (that is to-issues) and does NOT set type:cluster / Wave (that is to-issues promotion)."
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
+
<!-- project-extension:protocol-v1:start -->
|
|
8
|
+
## Project extension
|
|
9
|
+
|
|
10
|
+
Before applying this Core skill, run `node scripts/project-skill-extension.mjs inspect --skill to-prd --json` from the Project root. When it returns `active`, read the returned `path` and apply it as additive Project instructions. When it returns `inactive`, continue with Core only. When it returns `blocked`, stop and report its diagnostic.
|
|
11
|
+
|
|
12
|
+
Project extensions may specialize Project details, but cannot weaken Core user gates, safety, ownership, or validation. A contradiction blocks and requires an Explicit fork.
|
|
13
|
+
<!-- project-extension:protocol-v1:end -->
|
|
14
|
+
|
|
7
15
|
# to-prd — Draft PRD to the Board
|
|
8
16
|
|
|
9
17
|
> **Skill identity (don't get confused):** the folder `to-prd` + invocation `/to-prd` map to Matt Pocock's upstream skill **`to-spec`**. Upstream renamed `to-prd` → `to-spec` (v1.1.0); we deliberately keep the folder name `to-prd` (invocation stability, and PRD is this workflow's vocabulary). Content remains our fork, compared against upstream `to-spec` @ `d574778`. Provenance/rename ledger: `docs/agents/provenance.md` (§Re-Sync-Log), at the project root.
|
|
@@ -4,6 +4,14 @@ disable-model-invocation: true
|
|
|
4
4
|
description: "Internal Program graph engine behind the public to-issues Planning facade. Turns an explicitly identified Program-PRD into execute-ready wave anchors and slice leaves after one complete chat preview. Kept as a disabled compatibility entrypoint for existing explicit invocations; normal routing always selects to-issues."
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
+
<!-- project-extension:protocol-v1:start -->
|
|
8
|
+
## Project extension
|
|
9
|
+
|
|
10
|
+
Before applying this Core skill, run `node scripts/project-skill-extension.mjs inspect --skill to-waves --json` from the Project root. When it returns `active`, read the returned `path` and apply it as additive Project instructions. When it returns `inactive`, continue with Core only. When it returns `blocked`, stop and report its diagnostic.
|
|
11
|
+
|
|
12
|
+
Project extensions may specialize Project details, but cannot weaken Core user gates, safety, ownership, or validation. A contradiction blocks and requires an Explicit fork.
|
|
13
|
+
<!-- project-extension:protocol-v1:end -->
|
|
14
|
+
|
|
7
15
|
# to-waves — Internal Program graph engine
|
|
8
16
|
|
|
9
17
|
This skill is an **Internal Program graph engine**, selected by `to-issues` only
|
|
@@ -4,6 +4,14 @@ disable-model-invocation: true
|
|
|
4
4
|
description: Triage issues through the project board workflow. Use when user wants to triage issues, review incoming bugs or feature requests, prepare issues for an AFK agent, or manage issue workflow.
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
+
<!-- project-extension:protocol-v1:start -->
|
|
8
|
+
## Project extension
|
|
9
|
+
|
|
10
|
+
Before applying this Core skill, run `node scripts/project-skill-extension.mjs inspect --skill triage --json` from the Project root. When it returns `active`, read the returned `path` and apply it as additive Project instructions. When it returns `inactive`, continue with Core only. When it returns `blocked`, stop and report its diagnostic.
|
|
11
|
+
|
|
12
|
+
Project extensions may specialize Project details, but cannot weaken Core user gates, safety, ownership, or validation. A contradiction blocks and requires an Explicit fork.
|
|
13
|
+
<!-- project-extension:protocol-v1:end -->
|
|
14
|
+
|
|
7
15
|
# Triage
|
|
8
16
|
|
|
9
17
|
Move issues on the project issue tracker through the board-driven workflow.
|
|
@@ -3,6 +3,14 @@ name: verify-spike
|
|
|
3
3
|
description: Answer a single yes/no factual question about reality with a minimal throwaway, read-only harness and output-proof. Use when a plan, ADR, or implementation hinges on an empirically-checkable fact — does a library API exist / behave this way on this version, does the runtime / DB / platform actually have this capability, does an external assumption hold — and you need a proven verdict before locking the decision. NOT for design exploration (prototype), bug root-cause (diagnose), or building a feature (tdd).
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
+
<!-- project-extension:protocol-v1:start -->
|
|
7
|
+
## Project extension
|
|
8
|
+
|
|
9
|
+
Before applying this Core skill, run `node scripts/project-skill-extension.mjs inspect --skill verify-spike --json` from the Project root. When it returns `active`, read the returned `path` and apply it as additive Project instructions. When it returns `inactive`, continue with Core only. When it returns `blocked`, stop and report its diagnostic.
|
|
10
|
+
|
|
11
|
+
Project extensions may specialize Project details, but cannot weaken Core user gates, safety, ownership, or validation. A contradiction blocks and requires an Explicit fork.
|
|
12
|
+
<!-- project-extension:protocol-v1:end -->
|
|
13
|
+
|
|
6
14
|
# Verify Spike
|
|
7
15
|
|
|
8
16
|
A verify-spike is **throwaway, read-only code that proves a yes/no fact about reality.** The question is binary; the spike makes the answer empirical instead of assumed.
|
|
@@ -4,6 +4,14 @@ description: Plan a huge chunk of work — more than one agent session can hold
|
|
|
4
4
|
disable-model-invocation: true
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
+
<!-- project-extension:protocol-v1:start -->
|
|
8
|
+
## Project extension
|
|
9
|
+
|
|
10
|
+
Before applying this Core skill, run `node scripts/project-skill-extension.mjs inspect --skill wayfinder --json` from the Project root. When it returns `active`, read the returned `path` and apply it as additive Project instructions. When it returns `inactive`, continue with Core only. When it returns `blocked`, stop and report its diagnostic.
|
|
11
|
+
|
|
12
|
+
Project extensions may specialize Project details, but cannot weaken Core user gates, safety, ownership, or validation. A contradiction blocks and requires an Explicit fork.
|
|
13
|
+
<!-- project-extension:protocol-v1:end -->
|
|
14
|
+
|
|
7
15
|
A loose idea has arrived — too big for one agent session, and wrapped in fog: the way from here to the **destination** isn't visible yet. Wayfinding is about finding that way, not charging at the destination. This skill charts the way as a **shared map** on the repo's issue tracker, then works its tickets one at a time until the route is clear.
|
|
8
16
|
|
|
9
17
|
The destination varies per effort, and naming it is the first act of charting — it shapes every ticket. It might be a spec to hand off and iterate on, a decision to lock before planning starts, or a change made in place like a data-structure migration. The map is domain-agnostic — engineering work, course content, whatever fits the shape.
|
|
@@ -14,6 +14,14 @@ description: >-
|
|
|
14
14
|
push, a conflicting PR, or red (FAILURE) checks.
|
|
15
15
|
---
|
|
16
16
|
|
|
17
|
+
<!-- project-extension:protocol-v1:start -->
|
|
18
|
+
## Project extension
|
|
19
|
+
|
|
20
|
+
Before applying this Core skill, run `node scripts/project-skill-extension.mjs inspect --skill wrapup --json` from the Project root. When it returns `active`, read the returned `path` and apply it as additive Project instructions. When it returns `inactive`, continue with Core only. When it returns `blocked`, stop and report its diagnostic.
|
|
21
|
+
|
|
22
|
+
Project extensions may specialize Project details, but cannot weaken Core user gates, safety, ownership, or validation. A contradiction blocks and requires an Explicit fork.
|
|
23
|
+
<!-- project-extension:protocol-v1:end -->
|
|
24
|
+
|
|
17
25
|
# wrapup — land PR & tear down worktree
|
|
18
26
|
|
|
19
27
|
Trigger: user types `/wrapup` (optionally with a PR number). **Manual only** — `disable-model-invocation: true`, no hook, no auto-invoke.
|
|
@@ -3,6 +3,14 @@ name: write-a-skill
|
|
|
3
3
|
description: Create, write, edit, and improve agent skills — the vocabulary and principles that make a skill predictable (invocation, information hierarchy, progressive disclosure, leading words, pruning, failure modes). Use when the user wants to create, write, edit, refactor, or improve a skill.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
+
<!-- project-extension:protocol-v1:start -->
|
|
7
|
+
## Project extension
|
|
8
|
+
|
|
9
|
+
Before applying this Core skill, run `node scripts/project-skill-extension.mjs inspect --skill write-a-skill --json` from the Project root. When it returns `active`, read the returned `path` and apply it as additive Project instructions. When it returns `inactive`, continue with Core only. When it returns `blocked`, stop and report its diagnostic.
|
|
10
|
+
|
|
11
|
+
Project extensions may specialize Project details, but cannot weaken Core user gates, safety, ownership, or validation. A contradiction blocks and requires an Explicit fork.
|
|
12
|
+
<!-- project-extension:protocol-v1:end -->
|
|
13
|
+
|
|
6
14
|
# Writing Skills
|
|
7
15
|
|
|
8
16
|
> **Skill identity (don't get confused):** the folder `write-a-skill` + invocation `/write-a-skill` map to Matt Pocock's upstream skill **`writing-great-skills`**. Upstream replaced the old process-/template-based `write-a-skill` with this vocabulary/principles reference and switched it to **user-invoked** (`disable-model-invocation: true`). We keep the folder name `write-a-skill` (invocation stability) **and** deliberately keep it **model-invoked** (auto-fires on "create/write a skill" + `/write-a-skill`, as referenced in CLAUDE.md `## Workflow`). Content = upstream `writing-great-skills` @ `7a83a3a`, locally adapted. Provenance/rename ledger: `docs/agents/provenance.md` (§Re-Sync-Log), at the project root.
|
package/README.md
CHANGED
|
@@ -331,13 +331,16 @@ npx github:iKon85/agent-workflow-kit uninstall # remove kit-installed files
|
|
|
331
331
|
- a file you **did** edit is kept — the incoming version is backed up with a
|
|
332
332
|
timestamp and a diff is printed, never silently overwritten;
|
|
333
333
|
- a file you intentionally fork can be detached with
|
|
334
|
-
`npx github:iKon85/agent-workflow-kit own <path
|
|
334
|
+
`npx github:iKon85/agent-workflow-kit own <path> --as=explicit-fork`, retained
|
|
335
|
+
temporarily with `--as=contribution-bridge`, and returned to kit ownership
|
|
335
336
|
with `npx github:iKon85/agent-workflow-kit disown <path>`; owned files are
|
|
336
337
|
skipped by updates even after the package stops shipping them;
|
|
337
338
|
- a file removed upstream is offered for deletion (a hook still referenced by your
|
|
338
339
|
`settings.json` is kept regardless);
|
|
339
|
-
- a new
|
|
340
|
-
|
|
340
|
+
- a new Kit path that already exists locally is an `ambiguous-collision` until
|
|
341
|
+
an interactive or automated caller explicitly classifies it as a Project
|
|
342
|
+
extension, Contribution Bridge, Explicit fork, or clean Core; `--yes` never
|
|
343
|
+
chooses that interpretation and never overwrites the path;
|
|
341
344
|
- new skills without a local collision are added.
|
|
342
345
|
|
|
343
346
|
Ownership survives repeated `init`, including `init --force`: consumer-owned
|
|
@@ -354,7 +357,24 @@ Containment and file type are revalidated when read.
|
|
|
354
357
|
Ownership commands are designed for a single-user CLI workflow and are not
|
|
355
358
|
concurrency-safe. Do not run manifest-mutating commands concurrently. Flags:
|
|
356
359
|
`--force` (overwrite pre-existing untracked files on `init`), `--yes` / `-y`
|
|
357
|
-
(
|
|
360
|
+
(confirm only already-classified safe update actions), and
|
|
361
|
+
`--as=contribution-bridge|explicit-fork` for `own`.
|
|
362
|
+
|
|
363
|
+
### Project extensions versus forks
|
|
364
|
+
|
|
365
|
+
Every shipped skill probes the optional consumer-owned
|
|
366
|
+
`docs/agents/skills/<skill>.md` after loading its canonical Core. New
|
|
367
|
+
extensions declare
|
|
368
|
+
`<!-- agent-workflow-kit: project-extension/v1; skill=<skill> -->`; existing
|
|
369
|
+
non-empty unmarked files remain supported as legacy v0. Claude and Codex use
|
|
370
|
+
the same extension path and fail closed on an unknown schema or mismatched
|
|
371
|
+
identity.
|
|
372
|
+
|
|
373
|
+
Use an extension for Project-specific language, commands, policy, or
|
|
374
|
+
capability data. It augments Core and survives setup and updates byte-for-byte;
|
|
375
|
+
it cannot weaken Core gates or replace executable semantics. If you need to
|
|
376
|
+
change parsing, migration, evaluation, or other executable behavior, create an
|
|
377
|
+
Explicit fork with its own identity and update line instead.
|
|
358
378
|
|
|
359
379
|
## Upgrade notes
|
|
360
380
|
|
|
@@ -387,6 +407,100 @@ the old way. Decision record:
|
|
|
387
407
|
|
|
388
408
|
## Release notes
|
|
389
409
|
|
|
410
|
+
### 0.35.0
|
|
411
|
+
|
|
412
|
+
- added: `scripts/project-skill-extension.mjs`
|
|
413
|
+
- added: `src/lib/ownershipClassifier.mjs`
|
|
414
|
+
- added: `src/lib/projectSkillExtension.mjs`
|
|
415
|
+
- added: `src/lib/skillRegistry.mjs`
|
|
416
|
+
- added: `src/lib/updateDecisions.mjs`
|
|
417
|
+
- changed: `.agents/skills/ask-matt/SKILL.md`
|
|
418
|
+
- changed: `.agents/skills/audit-skills/SKILL.md`
|
|
419
|
+
- changed: `.agents/skills/board-to-waves/SKILL.md`
|
|
420
|
+
- changed: `.agents/skills/census-update/SKILL.md`
|
|
421
|
+
- changed: `.agents/skills/code-review/SKILL.md`
|
|
422
|
+
- changed: `.agents/skills/codebase-design/SKILL.md`
|
|
423
|
+
- changed: `.agents/skills/codex-adapter-sync/SKILL.md`
|
|
424
|
+
- changed: `.agents/skills/decision-gate/SKILL.md`
|
|
425
|
+
- changed: `.agents/skills/diagnose/SKILL.md`
|
|
426
|
+
- changed: `.agents/skills/domain-modeling/SKILL.md`
|
|
427
|
+
- changed: `.agents/skills/git-worktree-recover/SKILL.md`
|
|
428
|
+
- changed: `.agents/skills/grill-me/SKILL.md`
|
|
429
|
+
- changed: `.agents/skills/grill-with-docs/SKILL.md`
|
|
430
|
+
- changed: `.agents/skills/implement/SKILL.md`
|
|
431
|
+
- changed: `.agents/skills/improve-codebase-architecture/SKILL.md`
|
|
432
|
+
- changed: `.agents/skills/kit-release/SKILL.md`
|
|
433
|
+
- changed: `.agents/skills/kit-update/SKILL.md`
|
|
434
|
+
- changed: `.agents/skills/local-ci/SKILL.md`
|
|
435
|
+
- changed: `.agents/skills/memory-lifecycle/SKILL.md`
|
|
436
|
+
- changed: `.agents/skills/orchestrate-wave/SKILL.md`
|
|
437
|
+
- changed: `.agents/skills/project-release/SKILL.md`
|
|
438
|
+
- changed: `.agents/skills/prototype/SKILL.md`
|
|
439
|
+
- changed: `.agents/skills/research/SKILL.md`
|
|
440
|
+
- changed: `.agents/skills/resolving-merge-conflicts/SKILL.md`
|
|
441
|
+
- changed: `.agents/skills/retro/SKILL.md`
|
|
442
|
+
- changed: `.agents/skills/scale-check/SKILL.md`
|
|
443
|
+
- changed: `.agents/skills/security-audit/SKILL.md`
|
|
444
|
+
- changed: `.agents/skills/setup-workflow/SKILL.md`
|
|
445
|
+
- changed: `.agents/skills/setup-workflow/orchestrate-wave-seed.md`
|
|
446
|
+
- changed: `.agents/skills/setup-workflow/spec-self-critique-seed.md`
|
|
447
|
+
- changed: `.agents/skills/spec-self-critique/SKILL.md`
|
|
448
|
+
- changed: `.agents/skills/tdd/SKILL.md`
|
|
449
|
+
- changed: `.agents/skills/to-issues/SKILL.md`
|
|
450
|
+
- changed: `.agents/skills/to-prd/SKILL.md`
|
|
451
|
+
- changed: `.agents/skills/to-waves/SKILL.md`
|
|
452
|
+
- changed: `.agents/skills/triage/SKILL.md`
|
|
453
|
+
- changed: `.agents/skills/verify-spike/SKILL.md`
|
|
454
|
+
- changed: `.agents/skills/wayfinder/SKILL.md`
|
|
455
|
+
- changed: `.agents/skills/wrapup/SKILL.md`
|
|
456
|
+
- changed: `.claude/skills/ask-matt/SKILL.md`
|
|
457
|
+
- changed: `.claude/skills/audit-skills/SKILL.md`
|
|
458
|
+
- changed: `.claude/skills/board-to-waves/SKILL.md`
|
|
459
|
+
- changed: `.claude/skills/census-update/SKILL.md`
|
|
460
|
+
- changed: `.claude/skills/code-review/SKILL.md`
|
|
461
|
+
- changed: `.claude/skills/codebase-design/SKILL.md`
|
|
462
|
+
- changed: `.claude/skills/codex-build/SKILL.md`
|
|
463
|
+
- changed: `.claude/skills/codex-review/SKILL.md`
|
|
464
|
+
- changed: `.claude/skills/decision-gate/SKILL.md`
|
|
465
|
+
- changed: `.claude/skills/diagnose/SKILL.md`
|
|
466
|
+
- changed: `.claude/skills/domain-modeling/SKILL.md`
|
|
467
|
+
- changed: `.claude/skills/git-guardrails-claude-code/SKILL.md`
|
|
468
|
+
- changed: `.claude/skills/git-worktree-recover/SKILL.md`
|
|
469
|
+
- changed: `.claude/skills/grill-me-codex/SKILL.md`
|
|
470
|
+
- changed: `.claude/skills/grill-me/SKILL.md`
|
|
471
|
+
- changed: `.claude/skills/grill-with-docs-codex/SKILL.md`
|
|
472
|
+
- changed: `.claude/skills/grill-with-docs/SKILL.md`
|
|
473
|
+
- changed: `.claude/skills/implement/SKILL.md`
|
|
474
|
+
- changed: `.claude/skills/improve-codebase-architecture/SKILL.md`
|
|
475
|
+
- changed: `.claude/skills/kit-release/SKILL.md`
|
|
476
|
+
- changed: `.claude/skills/kit-update/SKILL.md`
|
|
477
|
+
- changed: `.claude/skills/local-ci/SKILL.md`
|
|
478
|
+
- changed: `.claude/skills/memory-lifecycle/SKILL.md`
|
|
479
|
+
- changed: `.claude/skills/orchestrate-wave/SKILL.md`
|
|
480
|
+
- changed: `.claude/skills/project-release/SKILL.md`
|
|
481
|
+
- changed: `.claude/skills/prototype/SKILL.md`
|
|
482
|
+
- changed: `.claude/skills/research/SKILL.md`
|
|
483
|
+
- changed: `.claude/skills/resolving-merge-conflicts/SKILL.md`
|
|
484
|
+
- changed: `.claude/skills/retro/SKILL.md`
|
|
485
|
+
- changed: `.claude/skills/scale-check/SKILL.md`
|
|
486
|
+
- changed: `.claude/skills/security-audit/SKILL.md`
|
|
487
|
+
- changed: `.claude/skills/setup-pre-commit/SKILL.md`
|
|
488
|
+
- changed: `.claude/skills/setup-workflow/SKILL.md`
|
|
489
|
+
- changed: `.claude/skills/setup-workflow/orchestrate-wave-seed.md`
|
|
490
|
+
- changed: `.claude/skills/setup-workflow/spec-self-critique-seed.md`
|
|
491
|
+
- changed: `.claude/skills/spec-self-critique/SKILL.md`
|
|
492
|
+
- changed: `.claude/skills/tdd/SKILL.md`
|
|
493
|
+
- changed: `.claude/skills/to-issues/SKILL.md`
|
|
494
|
+
- changed: `.claude/skills/to-prd/SKILL.md`
|
|
495
|
+
- changed: `.claude/skills/to-waves/SKILL.md`
|
|
496
|
+
- changed: `.claude/skills/triage/SKILL.md`
|
|
497
|
+
- changed: `.claude/skills/verify-spike/SKILL.md`
|
|
498
|
+
- changed: `.claude/skills/wayfinder/SKILL.md`
|
|
499
|
+
- changed: `.claude/skills/wrapup/SKILL.md`
|
|
500
|
+
- changed: `.claude/skills/write-a-skill/SKILL.md`
|
|
501
|
+
- changed: `scripts/readiness.mjs`
|
|
502
|
+
- changed: `src/lib/manifest.mjs`
|
|
503
|
+
|
|
390
504
|
### 0.34.6
|
|
391
505
|
|
|
392
506
|
- changed: `.agents/skills/kit-release/SKILL.md`
|