From 22fbd6da7391c35e410918ea6c3a76181d912008 Mon Sep 17 00:00:00 2001 From: hraness Date: Sat, 19 Sep 2026 02:27:47 -0400 Subject: [PATCH 1/4] docs: add ALGAL skills guidance --- AGENTS.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index a1c9cf34..03769bb1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -61,3 +61,12 @@ - Keep authenticated browser, interactive auth, 2FA, private local data, Mac-native, signing, release, deployment, production, agent-phase secret, agent-phase network, and exact-model work on its authoritative local or CI lane. - Give every editable Cloud task one unique branch and owner. Cloud workers may run focused validation but may not merge, weaken gates, release, deploy, or replace the repository's final exact-tree validation. + + +## ALGAL skills + +- Prefer the globally installed `algal-*` skills for bounded git state, diffs, repository survey/search, test and release gates, CI polling, and web fetches instead of repeated raw tool output. +- At session start, if the `algal` skill is unavailable, install all eight skills for Claude Code, Codex, and Devin for Terminal with `bunx skills add 0thernet/algal-skills --global --agent claude-code codex devin --skill '*' --copy --yes`. +- Confirm installation with `bunx skills list --global`. If Bun or network access is unavailable, continue with repository-native tools instead of blocking delivery. +- Treat ALGAL receipts as execution evidence, not provider attestation, and preserve the repository's normal verification and release gates. + From d5f859e421879fe601d11a3e2cc2744c7481bccc Mon Sep 17 00:00:00 2001 From: hraness Date: Sat, 19 Sep 2026 02:48:10 -0400 Subject: [PATCH 2/4] docs: keep ALGAL skill count current --- AGENTS.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index 03769bb1..c6b3bc56 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -66,7 +66,7 @@ ## ALGAL skills - Prefer the globally installed `algal-*` skills for bounded git state, diffs, repository survey/search, test and release gates, CI polling, and web fetches instead of repeated raw tool output. -- At session start, if the `algal` skill is unavailable, install all eight skills for Claude Code, Codex, and Devin for Terminal with `bunx skills add 0thernet/algal-skills --global --agent claude-code codex devin --skill '*' --copy --yes`. +- At session start, if the `algal` skill is unavailable, install the current skill pack for Claude Code, Codex, and Devin for Terminal with `bunx skills add 0thernet/algal-skills --global --agent claude-code codex devin --skill '*' --copy --yes`. - Confirm installation with `bunx skills list --global`. If Bun or network access is unavailable, continue with repository-native tools instead of blocking delivery. - Treat ALGAL receipts as execution evidence, not provider attestation, and preserve the repository's normal verification and release gates. From 8a4018ac57bab2f0223f7cf9196e23e722b1f426 Mon Sep 17 00:00:00 2001 From: hraness Date: Sat, 19 Sep 2026 03:01:12 -0400 Subject: [PATCH 3/4] docs: preserve root agent-guide heading contract --- AGENTS.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index c6b3bc56..a490177e 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -63,8 +63,6 @@ -## ALGAL skills - - Prefer the globally installed `algal-*` skills for bounded git state, diffs, repository survey/search, test and release gates, CI polling, and web fetches instead of repeated raw tool output. - At session start, if the `algal` skill is unavailable, install the current skill pack for Claude Code, Codex, and Devin for Terminal with `bunx skills add 0thernet/algal-skills --global --agent claude-code codex devin --skill '*' --copy --yes`. - Confirm installation with `bunx skills list --global`. If Bun or network access is unavailable, continue with repository-native tools instead of blocking delivery. From 6920c8a520f8eb2b504e25b85de030f9015af5a3 Mon Sep 17 00:00:00 2001 From: 0thernet Date: Sat, 19 Sep 2026 11:13:26 -0400 Subject: [PATCH 4/4] docs: add conditional System One skills guidance --- AGENTS.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index a490177e..7083b0b1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -62,9 +62,9 @@ - Give every editable Cloud task one unique branch and owner. Cloud workers may run focused validation but may not merge, weaken gates, release, deploy, or replace the repository's final exact-tree validation. - -- Prefer the globally installed `algal-*` skills for bounded git state, diffs, repository survey/search, test and release gates, CI polling, and web fetches instead of repeated raw tool output. -- At session start, if the `algal` skill is unavailable, install the current skill pack for Claude Code, Codex, and Devin for Terminal with `bunx skills add 0thernet/algal-skills --global --agent claude-code codex devin --skill '*' --copy --yes`. -- Confirm installation with `bunx skills list --global`. If Bun or network access is unavailable, continue with repository-native tools instead of blocking delivery. -- Treat ALGAL receipts as execution evidence, not provider attestation, and preserve the repository's normal verification and release gates. - + +- Use `system-one-*` skills for repeated evidence gathering only when their bounded result fits the task. Include startup, invocation, retries, and follow-up reads when assessing savings; smaller output alone does not prove lower token cost or preserved correctness. +- When the task benefits and installation is authorized, install the current pack for Claude Code, Codex, and Devin for Terminal with `bunx skills add 0thernet/system-one-skills --global --agent claude-code codex devin --skill '*' --copy --yes`; otherwise use repository-native tools. +- Confirm installation with `bunx skills list --global`. If Bun or network access is unavailable, continue with repository-native tools. +- Treat clipping as incomplete evidence: widen the read or use native tools before making claims that depend on omitted details. Typed output and replayable receipts do not establish semantic correctness; preserve required repository checks and independent review. +