Skip to content

feat: compile the agentic workflow skill library (13 skills) - #3

Merged
trefeon merged 1 commit into
mainfrom
feat/agentic-workflow-skills
Oct 16, 2026
Merged

trefeon merged 1 commit into
mainfrom
feat/agentic-workflow-skills

Conversation

@trefeon

@trefeon trefeon commented Oct 16, 2026

Copy link
Copy Markdown
Owner

Changes the repo's goal from a scanner to the agentic-AI work standard: the deterministic engine stays (569 rules, 9 domains) and the reference corpus is now compiled into a portable workflow skill library that the engine keeps honest.

The workflow library: 13 agentic-* skills

Each skill owns exactly one decision, names the sibling to use instead, cites the corpus path behind every non-obvious claim, and passes the repo's own scanner at 0 errors.

skill owns not for
agentic-frame framing a raw request: goal, acceptance criteria, scope boundary, ask-vs-proceed sequencing (agentic-plan)
agentic-plan execution shape: plan doc plus prototype, slices, contract-first, risk-scaled rigor goal choice; evidence (agentic-verify)
agentic-delegate work split across agents: slice design, briefs, isolation, integration review long-run supervision (agentic-loops)
agentic-context window engineering: budgets, progressive disclosure, files as memory, compaction durable memory (agentic-memory)
agentic-verify proving work: evidence classes, falsification, failing-before/passing-after diagnosis (agentic-debug)
agentic-debug wrong or unexplained behavior: reproduce, narrow, bisect, root cause, stop rules verification; performance tuning
agentic-review judging a diff: review axes, receiving review, merge gate git mechanics (agentic-git)
agentic-git workspace and history: worktrees, branches, commit subjects, PR flow review content; release steps
agentic-secure secrets and supply chain: approval gates, pre-push scanning, untrusted content, pinning app-security review; CI config rules
agentic-memory durable knowledge: what to save, project vs global, recall, staleness, handoff within-window context (agentic-context)
agentic-skill authoring instruction artifacts: frontmatter, triggers, budgets, testing, non-overlap auditing slop (slop-audit-skill)
agentic-harness the agent's environment: tool design, permissions, hosted runtimes, observability delegation; secrets policy
agentic-loops operating over time: budgets, stop conditions, drift, escalation, eval loops one-shot fan-out (agentic-delegate)

Compiled from the corpus's own workflow material: superpowers (15 skills), agent-skills (25), agent-skills-for-context-engineering (24), anthropics-skills, agentskills spec, DevOps-Security-Agent-Skills, fast-agent, hermes-agent-self-evolution, obsidian-skills. The corpus ships 60+ overlapping workflow skills; the library is the compiled, non-overlapping subset, with each source's prescriptions distilled rather than copied and the thin spots reported instead of padded.

The audit family (slop-audit*, 10 packs) is unchanged in intent: it judges a finished artifact against the rules DB, while agentic-* governs the work before the artifact exists. The zero-slop router now routes both families.

Citation layer fix

The corpus is cloned flat as reference/<manifest-name>/, but the packs cited 23 owner/repo forms that do not resolve on disk (reference/obra/superpowers:..., reference/jakubkrehel/skills:...) plus bare tail citations after a ; separator. scripts/fix-citations.mjs maps every citation through scripts/reference-corpus.json (owner/repo to manifest name) and normalizes the tail form. Result: 112 two-segment citations, 0 unresolved, with each tail verified against the corpus path. The script stays next to sync-reference.mjs because the corpus refreshes.

Install truth

  • The README claimed npx -y zero-slop@latest scan .. The unscoped zero-slop name on npm belongs to another project (manavmishra/ZeroSlop), so that command executed a stranger's package. Every install command in the README, docs/PUBLIC_ADOPTION.md, docs/SHIP_PLAN.md and the zero-slop router now names @zero-slop/cli, and the README states the CLI is not published yet with the clone path to run today.
  • Added a root pnpm build (core then CLI), which is what the clone instructions use.
  • The npm version badge was removed until the package exists; the publish path is .github/workflows/publish.yml on a v* tag.
  • Skills are installable today and this was verified live: npx skills use trefeon/zero-slop@slop-audit fetched the pack from the public repo and rendered its SKILL.md.

Docs

README (new tagline, install, workflow-library table), docs/MULTI_AGENT_SKILLS.md (two families, tree), docs/SHIP_PLAN.md (M1.8 checklist, state line, the fixed ship-acceptance command), docs/ZERO_SLOP_FRAMEWORK.md (goal, 84-repo evidence base, M1.8 milestone), root package.json description.

Verification

  • Every skill gates at 0 errors individually and gate skills/ covers the whole tree; gate docs/ and gate README.md also 0 errors.
  • pnpm validate:rules healthy, pnpm typecheck clean, core and CLI test suites pass.
  • Full-repo gate: 0 error-tier findings.
  • Public-repo scanners: gitleaks clean; trufflehog clean with sensitivity proven by a high-entropy control.

Not in this PR

npm publish (needs npm auth or trusted-publisher setup), the GitHub Action, the MCP server.

Changes the repo's goal from a scanner to the agentic-AI work standard: the
deterministic engine stays (569 rules, 9 domains) and the reference corpus is
now compiled into a portable workflow skill library that the engine keeps
honest.

Adds 13 agentic-* skills, one decision each, with sibling boundaries and
corpus citations: frame, plan, delegate, context, verify, debug, review, git,
secure, memory, skill, harness, loops. Compiled from the corpus's own workflow
material (superpowers, agent-skills, agent-skills-for-context-engineering,
anthropics-skills, the agentskills spec, DevOps-Security-Agent-Skills,
fast-agent, hermes-agent-self-evolution, obsidian-skills); every non-obvious
claim cites a corpus path, thin sources are reported instead of padded, and
every file gates at 0 errors.

Fixes the citation layer: 23 owner/repo citation forms did not resolve on disk
because the corpus is cloned flat; scripts/fix-citations.mjs maps them through
scripts/reference-corpus.json and normalizes the bare tail form, leaving 112
two-segment citations with 0 unresolved. Adds
scripts/check-workflow-library.mjs (name, frontmatter, required sections,
description uniqueness, cross-skill sentence duplication).

Corrects the install story: the README's npx line named the unscoped zero-slop
package, which belongs to another project; every command now names
@zero-slop/cli, the README states the CLI is unpublished with the clone path to
run today, the npm badge is dropped until the package exists, and a root pnpm
build script is added. The skills install from this repo today.

Docs: README, MULTI_AGENT_SKILLS, SHIP_PLAN (M1.8), ZERO_SLOP_FRAMEWORK (goal
and 84-repo evidence base), package.json description, and the zero-slop router
now routes both families.

Gates: 23 packs, skills/ 0 errors, docs/ 0 errors, whole repo 0 errors, 614
core + 12 CLI tests, validate:rules healthy, gitleaks and trufflehog clean.
Copilot AI balanced review requested due to automatic review settings October 16, 2026 08:43

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@trefeon
trefeon merged commit 2144caa into main Oct 16, 2026
1 check passed
@trefeon
trefeon deleted the feat/agentic-workflow-skills branch October 16, 2026 08:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants