claude-dev-env 2.15.1 → 2.17.0

package/skills/AGENTS.md

@@ -1,72 +0,0 @@
-# Skills Directory
-
-Each skill is a self-contained folder Claude Code loads on demand. At startup, only the skill's `name` and `description` metadata load. The full `SKILL.md` body and any support files load only when a skill becomes relevant to the conversation.
-
-## Skill folder convention
-
-| Item | Role |
-|---|---|
-| `SKILL.md` | Required entry point. YAML frontmatter with `name` and `description` (the trigger). Body holds the skill's full instructions. |
-| `scripts/` | Python helper scripts the skill invokes at runtime. |
-| `workflow/` | `.mjs` workflow scripts run via the `Workflow` tool. |
-| `templates/` | Template files the skill or workflow renders at build time. |
-| `reference/` | Reference docs the skill cites or the workflow reads. |
-| `*_constants/` | Python package of named constants imported by `scripts/`. |
-
-Skills install to `~/.claude/skills/<skill-name>/` via `packages/claude-dev-env/bin/install.mjs`. See `docs/references/skill-install-system.md` for the install pipeline.
-
-## Shared support code
-
-**`skills/_shared/`** — skill-local PR-loop helpers plus `@` stubs that name
-canonical homes under **`@~/.claude/_shared/`** (advisor protocol, PR-loop
-contracts, runtime scripts). Map: `skills/_shared/CLAUDE.md`. End-of-run gotchas: `skills/_shared/end-of-run-gotcha-recommendations.md`.
-
-## Skill groups
-
-**Planning and implementation**
-- `anthropic-plan` — creates a source-grounded plan packet before any code changes
-- `orchestrator` — turns the session into the orchestrator: it spawns executor subagents to do the code edits and test runs; hard decisions go to a shared advisor (Claude warm `session-advisor` via SendMessage; a third-party host: max-tier Claude via CLI Claude-chain)
-- `orchestrator-refresh` — sub-skill fired by the `/orchestrator` loop to re-assert the host-matched shared-advisor discipline mid-run (Claude SendMessage; a third-party host's Claude CLI chain, no Agent-tool advisor spawn)
-- `team-advisor` — binds one advisor at the strongest reachable tier (Claude warm agent; a third-party host: max-tier Claude via CLI Claude-chain, fail closed when unreachable); consult cadence and weight live in `docs/references/advisor-tool.md`
-- `grokify` — builds a paste-ready Grok Build handoff with a Claude advisor charter
-- `grok-spawn` — orchestrator playbook for fleets of headless grok CLI workers (preflight, batch spec, `spawn_grok_batch.py`)
-
-**PR review and convergence**
-- `autoconverge` — autonomous single-run workflow that drives a PR to ready
-- `pr-converge` — paced convergence loop across `ScheduleWakeup` ticks
-- `bugteam` — open-loop audit-fix until convergence
-- `copilot-review` — requests and polls a GitHub Copilot review
-- `copilot-finding-triage` — tiers each Copilot gate finding, verifies each code concern with an executed check, then routes it (auto-fix a confirmed defect, resolve a refuted one, page the user only for an inconclusive one)
-- `reviewer-gates` — availability gates for external reviewers (opt-out parse, Copilot quota, Bugbot trigger/detect)
-- `pr-fix-protocol` — applies reviewer findings as verified fixes and drives unresolved review threads to zero
-- `pr-loop-lifecycle` — opens and closes a PR-loop run (grant, teardown, PR description, revoke, report)
-- `pr-loop-cloud-transport` — six-step transport workflow that lets any PR-loop skill run in a session whose `gh` CLI is absent or cannot act on the PR (MCP schema load, origin/HEAD fix, identity rules, the gh-to-MCP substitution matrix, the Copilot status rule, and the post self-check)
-
-**Code review guides (Google eng-practices, adapted for an AI reviewer)**
-- `small-cl` — the Small CLs guide; refs: handling reviewer comments
-- `comments` — writing review comments and handling reviewer comments; refs: the review standard, pushback, respectful code reviews
-- `reviews` — the reviewer guide: standard, what to look for, navigating a CL, speed, pushback; refs: CL descriptions, review comments, emergencies, style guides, the two guide indexes
-- `descriptions` — writing good CL descriptions
-- `emergencies` — what counts as an emergency change; refs: what to look for, speed
-- Focused pull request guidance: [`small-cl/SKILL.md`](small-cl/SKILL.md)
-
-**Research and discovery**
-- `recall` — retrieves facts from memory files
-- `remember` — saves a decision, gotcha, or architectural choice to the Obsidian vault
-- `everything-search` — file-system search via the Everything `es.exe` CLI
-- `beat-sheet` — reformats a reply as short single-line beats
-- `show` — creates and reviews inline visual explanations: diagrams, interactive widgets, mockups, charts, and illustrations
-
-**Session and workflow management**
-- `session-log` — logs a session report to the Obsidian vault
-- `session-tidy` — tidies the session folder
-- `task-build` — gathers open tasks
-- `issue-tracker` — one consistent way to create, update in place, and close GitHub issues for a work-stream: one epic parent with native sub-issues, dedup-first, marker-delimited body sections edited in place, and an epic checklist mirroring the children
-- `closeout` — session-end entry that harvests obstacles into issue-candidate records and delegates filing to the `issue-tracker` agent (skill fallback), keeping the user-validation gate on each draft
-- `privacy-hygiene` — full-repo personal-data and secret sweep plus remediation guide
-- `update` — updates the dev-env package
-- `fresh-branch` — creates a clean branch off main
-- `rebase` — rebases onto main
-- `usage-pause` — waits out the 5-hour usage window in ScheduleWakeup stages that keep agent contexts warm; probes the OAuth usage endpoint or takes a manual reset override
-- `skill-builder` — complete skill-building lifecycle
-- `auditing-claude-config` — audits a Claude Code setup for context-budget waste and produces a migration table with savings

package/skills/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/_shared/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/_shared/advisor/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/_shared/pr-loop/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/_shared/pr-loop/prompts/AGENTS.md

@@ -1,9 +0,0 @@
-# prompts
-
-XML agent prompt templates for the PR audit-fix loop.
-
-## Key files
-
-| File | Role |
-|---|---|
-| `pr-consistency-audit.xml` | Structured prompt artifact for the cross-file consistency audit agent. Defines the agent role, scope anchors, a ten-rule detection workflow, and output format. `bugteam` and `pr-converge` both inject this prompt when running the consistency audit step. |

package/skills/_shared/pr-loop/prompts/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/_shared/pr-loop/scripts/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/_shared/pr-loop/scripts/skills_pr_loop_constants/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/anthropic-plan/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/anthropic-plan/scripts/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/anthropic-plan/scripts/anthropic_plan_scripts_constants/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/anthropic-plan/templates/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/anthropic-plan/workflow/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/auditing-claude-config/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/autoconverge/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/autoconverge/reference/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/autoconverge/workflow/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/autoconverge/workflow/autoconverge_report_constants/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/bugteam/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/bugteam/reference/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/bugteam/reference/obstacles/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/bugteam/scripts/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/bugteam/scripts/bugteam_scripts_constants/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/codex-review/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/codex-review/reference/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/codex-review/scripts/codex_review_scripts_constants/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/copilot-review/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/everything-search/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/fresh-branch/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/grok-spawn/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/skills/grokify/evals/README.md

@@ -1,72 +0,0 @@
-# Grok capability evals (opt-in only)
-
-Live measurements of Grok Build capabilities used by the `grokify` skill wording.
-
-**Manual / opt-in only.** These evals never gate default `npm test`, pr-check, or CI.
-
-## Requirements
-
-- `grok` on `PATH` and authenticated (`grok models` exits 0). The runner calls `grok` by default; set `GROK_BIN` to point it at another binary.
-- Network access for the Grok API
-- A writable platform temp directory (`$env:TEMP` on Windows, `$TMPDIR` / `/tmp` elsewhere)
-- For E3, an agent `grok` can load under `--agent`. The runner passes the agent named by `GROK_CAPABILITY_EVAL_AGENT` (default `Explore`); set that variable to an agent your `grok` resolves when the default does not exist for you.
-
-## Run
-
-From the package root (`packages/claude-dev-env`):
-
-```powershell
-# Windows PowerShell
-$env:GROK_CAPABILITY_EVALS = "1"
-node skills/grokify/evals/run-capability-evals.mjs
-```
-
-```bash
-# POSIX
-GROK_CAPABILITY_EVALS=1 node skills/grokify/evals/run-capability-evals.mjs
-```
-
-From this skill folder (`packages/claude-dev-env/skills/grokify`):
-
-```powershell
-# Windows PowerShell
-$env:GROK_CAPABILITY_EVALS = "1"
-node evals/run-capability-evals.mjs
-```
-
-```bash
-# POSIX
-GROK_CAPABILITY_EVALS=1 node evals/run-capability-evals.mjs
-```
-
-Or pass `--run` without the env var (paths match the cwd above):
-
-```powershell
-# from package root
-node skills/grokify/evals/run-capability-evals.mjs --run
-# from this skill folder
-node evals/run-capability-evals.mjs --run
-```
-
-Without `GROK_CAPABILITY_EVALS=1` or `--run`, the script prints how to opt in and exits 0 (no live calls).
-
-## What it measures
-
-| Eval | Assertion |
-|------|-----------|
-| E1 | `can_spawn_subagent_tool === true` and tool list includes `spawn_subagent` |
-| E2 | `spawn_succeeded === true` (child reports `SPAWN_OK`) |
-| E3 | `skill_read_ok === true` and `agent_definition_loaded === true` (skill file read under `--agent`) |
-| E4 | Probe write under the eval cwd succeeds (soft: hooks log may show `global/settings` + `pre_tool_use`) |
-| E5 | `has_workflow_tool === false` and `result === "no_tool"` (both fields agree on absence) |
-
-Each live `grok` call uses a unique `--leader-socket` under a fresh temp directory so concurrent runs do not share a socket.
-
-## Offline static guard
-
-`../capability-claims.test.mjs` runs under package `npm test` (no live `grok`):
-
-- `SKILL.md` must not contain `cannot spawn Claude subagents`
-- `SKILL.md` and the handoff template must still mention `claude -p` for the advisor path
-
-`parse-payload.test.mjs` also runs under package `npm test` (no live `grok`): it unit-tests the runner's output parser (`tryParseJsonObject`, `extractResultText`, `parsePayload`, `isWorkflowToolAbsent`).

package/skills/grokify/evals/parse-payload.test.mjs

@@ -1,171 +0,0 @@
-import { test } from 'node:test';
-import { strict as assert } from 'node:assert';
-import {
-  tryParseJsonObject,
-  extractResultText,
-  parsePayload,
-  isWorkflowToolAbsent,
-} from './run-capability-evals.mjs';
-
-const E1_CLAIM_PAYLOAD = {
-  can_spawn_subagent_tool: true,
-  tool_names: ['spawn_subagent'],
-  agents_dir_exists: true,
-  skills_dir_exists: true,
-};
-
-test('tryParseJsonObject parses a pure JSON object string', () => {
-  const parsed = tryParseJsonObject(JSON.stringify(E1_CLAIM_PAYLOAD));
-  assert.deepEqual(parsed, E1_CLAIM_PAYLOAD);
-});
-
-test('tryParseJsonObject strips leading prose before the first brace', () => {
-  const withProse = `Here is the inventory:\n${JSON.stringify(E1_CLAIM_PAYLOAD)}`;
-  const parsed = tryParseJsonObject(withProse);
-  assert.deepEqual(parsed, E1_CLAIM_PAYLOAD);
-});
-
-test('tryParseJsonObject extracts the object when trailing prose carries braces', () => {
-  const withTrailingBraces = `${JSON.stringify(E1_CLAIM_PAYLOAD)}\nNote: see {run-directory} for logs.`;
-  const parsed = tryParseJsonObject(withTrailingBraces);
-  assert.deepEqual(parsed, E1_CLAIM_PAYLOAD);
-});
-
-test('tryParseJsonObject ignores a stray brace pair in leading prose', () => {
-  const withLeadingBraces = `Here is the result (see {} for details):\n${JSON.stringify(E1_CLAIM_PAYLOAD)}`;
-  const parsed = tryParseJsonObject(withLeadingBraces);
-  assert.deepEqual(parsed, E1_CLAIM_PAYLOAD);
-});
-
-test('tryParseJsonObject returns null for empty input', () => {
-  assert.equal(tryParseJsonObject(''), null);
-  assert.equal(tryParseJsonObject('   '), null);
-});
-
-test('extractResultText reads Grok top-level text field', () => {
-  const nestedJson = JSON.stringify(E1_CLAIM_PAYLOAD);
-  const envelope = JSON.stringify({ text: nestedJson, model: 'grok' });
-  assert.equal(extractResultText(envelope), nestedJson);
-});
-
-test('extractResultText prefers Claude result over Grok text', () => {
-  const envelope = JSON.stringify({
-    result: '{"from":"result"}',
-    text: '{"from":"text"}',
-  });
-  assert.equal(extractResultText(envelope), '{"from":"result"}');
-});
-
-test('extractResultText prefers Grok text over a conversational message', () => {
-  const envelope = JSON.stringify({
-    message: 'working',
-    text: '{"from":"text"}',
-  });
-  assert.equal(extractResultText(envelope), '{"from":"text"}');
-});
-
-test('extractResultText reads Claude message field', () => {
-  const envelope = JSON.stringify({ message: '{"from":"message"}' });
-  assert.equal(extractResultText(envelope), '{"from":"message"}');
-});
-
-test('extractResultText reads Claude stream result events', () => {
-  const envelope = JSON.stringify([
-    { type: 'assistant', content: 'thinking' },
-    {
-      type: 'result',
-      result: JSON.stringify(E1_CLAIM_PAYLOAD),
-    },
-  ]);
-  assert.equal(extractResultText(envelope), JSON.stringify(E1_CLAIM_PAYLOAD));
-});
-
-test('extractResultText prefers the last result event in a stream array', () => {
-  const intermediateClaim = { can_spawn_subagent_tool: false, tool_names: [] };
-  const envelope = JSON.stringify([
-    { type: 'assistant', content: 'thinking' },
-    { type: 'result', result: JSON.stringify(intermediateClaim) },
-    { type: 'assistant', content: 'retry' },
-    { type: 'result', result: JSON.stringify(E1_CLAIM_PAYLOAD) },
-  ]);
-  assert.equal(extractResultText(envelope), JSON.stringify(E1_CLAIM_PAYLOAD));
-});
-
-test('parsePayload extracts nested claim JSON from Grok text envelope', () => {
-  const envelope = JSON.stringify({
-    text: JSON.stringify(E1_CLAIM_PAYLOAD),
-  });
-  const payload = parsePayload(envelope);
-  assert.equal(payload.can_spawn_subagent_tool, true);
-  assert.deepEqual(payload.tool_names, ['spawn_subagent']);
-});
-
-test('parsePayload extracts nested claim JSON when Grok text has leading prose', () => {
-  const envelope = JSON.stringify({
-    text: `Capability inventory complete.\n${JSON.stringify(E1_CLAIM_PAYLOAD)}`,
-  });
-  const payload = parsePayload(envelope);
-  assert.equal(payload.can_spawn_subagent_tool, true);
-  assert.equal(payload.agents_dir_exists, true);
-});
-
-test('parsePayload still reads Claude result envelopes', () => {
-  const envelope = JSON.stringify({
-    result: JSON.stringify(E1_CLAIM_PAYLOAD),
-  });
-  const payload = parsePayload(envelope);
-  assert.equal(payload.can_spawn_subagent_tool, true);
-});
-
-test('parsePayload still reads Claude message envelopes', () => {
-  const envelope = JSON.stringify({
-    message: JSON.stringify(E1_CLAIM_PAYLOAD),
-  });
-  const payload = parsePayload(envelope);
-  assert.equal(payload.can_spawn_subagent_tool, true);
-});
-
-test('parsePayload still reads Claude stream array envelopes', () => {
-  const envelope = JSON.stringify([
-    { type: 'message', content: 'working' },
-    { type: 'result', result: JSON.stringify(E1_CLAIM_PAYLOAD) },
-  ]);
-  const payload = parsePayload(envelope);
-  assert.equal(payload.can_spawn_subagent_tool, true);
-  assert.deepEqual(payload.tool_names, ['spawn_subagent']);
-});
-
-test('isWorkflowToolAbsent accepts consistent absence', () => {
-  assert.equal(
-    isWorkflowToolAbsent({ has_workflow_tool: false, result: 'no_tool' }),
-    true,
-  );
-});
-
-test('isWorkflowToolAbsent rejects contradictory true and no_tool', () => {
-  assert.equal(
-    isWorkflowToolAbsent({ has_workflow_tool: true, result: 'no_tool' }),
-    false,
-  );
-});
-
-test('isWorkflowToolAbsent rejects contradictory false and has_tool', () => {
-  assert.equal(
-    isWorkflowToolAbsent({ has_workflow_tool: false, result: 'has_tool' }),
-    false,
-  );
-});
-
-test('isWorkflowToolAbsent rejects consistent presence', () => {
-  assert.equal(
-    isWorkflowToolAbsent({ has_workflow_tool: true, result: 'has_tool' }),
-    false,
-  );
-});
-
-test('isWorkflowToolAbsent rejects partial or missing fields', () => {
-  assert.equal(isWorkflowToolAbsent({ has_workflow_tool: false }), false);
-  assert.equal(isWorkflowToolAbsent({ result: 'no_tool' }), false);
-  assert.equal(isWorkflowToolAbsent(null), false);
-  assert.equal(isWorkflowToolAbsent({}), false);
-});