From aaf52b6d2b5e1b024136949e9b64a06b26156836 Mon Sep 17 00:00:00 2001 From: Shinsuke Kagawa Date: Fri, 23 Oct 2026 21:59:40 +0900 Subject: [PATCH] fix: budget required skill reads before loading --- .agents/skills/recipe-add-integration-tests/SKILL.md | 2 ++ .agents/skills/recipe-build/SKILL.md | 2 ++ .agents/skills/recipe-design/SKILL.md | 2 ++ .agents/skills/recipe-diagnose/SKILL.md | 2 ++ .agents/skills/recipe-front-adjust/SKILL.md | 2 ++ .agents/skills/recipe-front-build/SKILL.md | 2 ++ .agents/skills/recipe-front-design/SKILL.md | 2 ++ .agents/skills/recipe-front-plan/SKILL.md | 2 ++ .agents/skills/recipe-front-review/SKILL.md | 2 ++ .agents/skills/recipe-fullstack-build/SKILL.md | 2 ++ .agents/skills/recipe-fullstack-implement/SKILL.md | 2 ++ .agents/skills/recipe-implement/SKILL.md | 2 ++ .agents/skills/recipe-plan/SKILL.md | 2 ++ .agents/skills/recipe-prepare-implementation/SKILL.md | 2 ++ .agents/skills/recipe-quality-profile/SKILL.md | 2 ++ .agents/skills/recipe-reverse-engineer/SKILL.md | 2 ++ .agents/skills/recipe-review/SKILL.md | 2 ++ .agents/skills/recipe-update-doc/SKILL.md | 2 ++ .codex/agents/acceptance-test-generator.toml | 2 ++ .codex/agents/code-reviewer.toml | 2 ++ .codex/agents/code-verifier.toml | 2 ++ .codex/agents/codebase-analyzer.toml | 2 ++ .codex/agents/design-sync.toml | 2 ++ .codex/agents/document-reviewer.toml | 2 ++ .codex/agents/integration-test-reviewer.toml | 2 ++ .codex/agents/investigator.toml | 2 ++ .codex/agents/prd-creator.toml | 2 ++ .codex/agents/quality-fixer-frontend.toml | 2 ++ .codex/agents/quality-fixer.toml | 2 ++ .codex/agents/requirement-analyzer.toml | 2 ++ .codex/agents/scope-discoverer.toml | 2 ++ .codex/agents/security-reviewer.toml | 2 ++ .codex/agents/solver.toml | 2 ++ .codex/agents/task-decomposer.toml | 2 ++ .codex/agents/task-executor-frontend.toml | 2 ++ .codex/agents/task-executor.toml | 2 ++ .codex/agents/technical-designer-frontend.toml | 2 ++ .codex/agents/technical-designer.toml | 2 ++ .codex/agents/technical-spike.toml | 2 ++ .codex/agents/ui-analyzer.toml | 2 ++ .codex/agents/ui-spec-designer.toml | 2 ++ .codex/agents/verifier.toml | 2 ++ .codex/agents/work-planner.toml | 2 ++ package.json | 2 +- 44 files changed, 87 insertions(+), 1 deletion(-) diff --git a/.agents/skills/recipe-add-integration-tests/SKILL.md b/.agents/skills/recipe-add-integration-tests/SKILL.md index bf8456f..597f45f 100644 --- a/.agents/skills/recipe-add-integration-tests/SKILL.md +++ b/.agents/skills/recipe-add-integration-tests/SKILL.md @@ -5,6 +5,8 @@ description: "Add integration/E2E tests to existing codebase using Design Docs." ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + 1. [LOAD IF NOT ACTIVE] `testing` — repository-aware test execution 2. [LOAD IF NOT ACTIVE] `integration-e2e-testing` — value-based integration/E2E selection 3. [LOAD IF NOT ACTIVE] `subagents-orchestration-guide` — review resolution and agent coordination diff --git a/.agents/skills/recipe-build/SKILL.md b/.agents/skills/recipe-build/SKILL.md index 9b3a5c3..7be2c0b 100644 --- a/.agents/skills/recipe-build/SKILL.md +++ b/.agents/skills/recipe-build/SKILL.md @@ -5,6 +5,8 @@ description: "Execute an approved backend Work Plan autonomously through task ex ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + 1. `coding-rules` 2. `testing` 3. `ai-development-guide` diff --git a/.agents/skills/recipe-design/SKILL.md b/.agents/skills/recipe-design/SKILL.md index 022514c..22b4a69 100644 --- a/.agents/skills/recipe-design/SKILL.md +++ b/.agents/skills/recipe-design/SKILL.md @@ -5,6 +5,8 @@ description: "Execute from codebase-scoped analysis to design document creation. ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + 1. [LOAD IF NOT ACTIVE] `documentation-criteria` — document creation rules and templates 2. [LOAD IF NOT ACTIVE] `subagents-orchestration-guide` — agent coordination and review resolution 3. [LOAD IF NOT ACTIVE] `requirement-convergence` — requirements hearing and scope-confirmation output diff --git a/.agents/skills/recipe-diagnose/SKILL.md b/.agents/skills/recipe-diagnose/SKILL.md index f8c19b5..51eb65f 100644 --- a/.agents/skills/recipe-diagnose/SKILL.md +++ b/.agents/skills/recipe-diagnose/SKILL.md @@ -5,6 +5,8 @@ description: "Investigate problem, verify findings, and derive solutions through ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + 1. [LOAD IF NOT ACTIVE] `ai-development-guide` — AI development patterns 2. [LOAD IF NOT ACTIVE] `coding-rules` — coding standards 3. [LOAD IF NOT ACTIVE] `llm-friendly-context` — clear prompts, handoffs, and generated artifacts diff --git a/.agents/skills/recipe-front-adjust/SKILL.md b/.agents/skills/recipe-front-adjust/SKILL.md index fd9546b..9a14ae0 100644 --- a/.agents/skills/recipe-front-adjust/SKILL.md +++ b/.agents/skills/recipe-front-adjust/SKILL.md @@ -7,6 +7,8 @@ description: "Adjust an implemented UI with focused evidence, verification, and ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + 1. [LOAD IF NOT ACTIVE] `subagents-orchestration-guide` -- agent coordination rules 2. [LOAD IF NOT ACTIVE] `llm-friendly-context` -- adjustment handoff and verification context diff --git a/.agents/skills/recipe-front-build/SKILL.md b/.agents/skills/recipe-front-build/SKILL.md index 89edc39..7612d67 100644 --- a/.agents/skills/recipe-front-build/SKILL.md +++ b/.agents/skills/recipe-front-build/SKILL.md @@ -5,6 +5,8 @@ description: "Execute an approved frontend Work Plan autonomously through fronte ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + 1. `coding-rules` 2. `testing` 3. `ai-development-guide` diff --git a/.agents/skills/recipe-front-design/SKILL.md b/.agents/skills/recipe-front-design/SKILL.md index f234d5a..c883d8d 100644 --- a/.agents/skills/recipe-front-design/SKILL.md +++ b/.agents/skills/recipe-front-design/SKILL.md @@ -7,6 +7,8 @@ description: "Execute from codebase-scoped analysis to frontend design document ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + 1. [LOAD IF NOT ACTIVE] `documentation-criteria` -- document quality standards 2. [LOAD IF NOT ACTIVE] `subagents-orchestration-guide` -- agent coordination and review resolution 3. [LOAD IF NOT ACTIVE] `requirement-convergence` -- requirements hearing and scope-confirmation output diff --git a/.agents/skills/recipe-front-plan/SKILL.md b/.agents/skills/recipe-front-plan/SKILL.md index 2a2b562..c0bd734 100644 --- a/.agents/skills/recipe-front-plan/SKILL.md +++ b/.agents/skills/recipe-front-plan/SKILL.md @@ -7,6 +7,8 @@ description: "Create frontend work plan from design document with test skeleton ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + 1. [LOAD IF NOT ACTIVE] `documentation-criteria` -- Work Plan scope and template 2. [LOAD IF NOT ACTIVE] `implementation-approach` -- implementation ordering and verification strategy 3. [LOAD IF NOT ACTIVE] `subagents-orchestration-guide` -- agent coordination and workflow flow diff --git a/.agents/skills/recipe-front-review/SKILL.md b/.agents/skills/recipe-front-review/SKILL.md index ad09d95..69af269 100644 --- a/.agents/skills/recipe-front-review/SKILL.md +++ b/.agents/skills/recipe-front-review/SKILL.md @@ -7,6 +7,8 @@ description: "Reviews completed frontend implementation for governing-source com ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + 1. [LOAD IF NOT ACTIVE] `coding-rules` -- repository implementation rules 2. [LOAD IF NOT ACTIVE] `testing` -- verification and test quality rules 3. [LOAD IF NOT ACTIVE] `ai-development-guide` -- review and repair discipline diff --git a/.agents/skills/recipe-fullstack-build/SKILL.md b/.agents/skills/recipe-fullstack-build/SKILL.md index 14dfde1..f2d3c2f 100644 --- a/.agents/skills/recipe-fullstack-build/SKILL.md +++ b/.agents/skills/recipe-fullstack-build/SKILL.md @@ -5,6 +5,8 @@ description: "Execute an approved fullstack Work Plan autonomously with layer-aw ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + 1. `coding-rules` 2. `testing` 3. `ai-development-guide` diff --git a/.agents/skills/recipe-fullstack-implement/SKILL.md b/.agents/skills/recipe-fullstack-implement/SKILL.md index 2db5b98..f79b6a8 100644 --- a/.agents/skills/recipe-fullstack-implement/SKILL.md +++ b/.agents/skills/recipe-fullstack-implement/SKILL.md @@ -5,6 +5,8 @@ description: "Run the full-cycle implementation workflow for one outcome spannin ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + 1. [LOAD IF NOT ACTIVE] `subagents-orchestration-guide` — Fullstack (Monorepo) Flow, approvals, and autonomous execution 2. [LOAD IF NOT ACTIVE] `documentation-criteria` — scale-selected document path 3. [LOAD IF NOT ACTIVE] `requirement-convergence` — outcome, exclusions, and rough-cost challenge diff --git a/.agents/skills/recipe-implement/SKILL.md b/.agents/skills/recipe-implement/SKILL.md index 55417d9..72bc535 100644 --- a/.agents/skills/recipe-implement/SKILL.md +++ b/.agents/skills/recipe-implement/SKILL.md @@ -5,6 +5,8 @@ description: "Orchestrate the complete implementation lifecycle from requirement ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + 1. [LOAD IF NOT ACTIVE] `subagents-orchestration-guide` — agent coordination and workflow routing 2. [LOAD IF NOT ACTIVE] `documentation-criteria` — scale-selected document path 3. [LOAD IF NOT ACTIVE] `requirement-convergence` — outcome, exclusion, and rough-cost convergence before design diff --git a/.agents/skills/recipe-plan/SKILL.md b/.agents/skills/recipe-plan/SKILL.md index 598bacd..a8bd916 100644 --- a/.agents/skills/recipe-plan/SKILL.md +++ b/.agents/skills/recipe-plan/SKILL.md @@ -5,6 +5,8 @@ description: "Creates a reviewed Work Plan with value-filtered integration/E2E t ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + 1. [LOAD IF NOT ACTIVE] `documentation-criteria` — Work Plan scope and template 2. [LOAD IF NOT ACTIVE] `implementation-approach` — implementation ordering and verification strategy 3. [LOAD IF NOT ACTIVE] `subagents-orchestration-guide` — agent coordination and workflow flow diff --git a/.agents/skills/recipe-prepare-implementation/SKILL.md b/.agents/skills/recipe-prepare-implementation/SKILL.md index c14dd57..aadc64a 100644 --- a/.agents/skills/recipe-prepare-implementation/SKILL.md +++ b/.agents/skills/recipe-prepare-implementation/SKILL.md @@ -5,6 +5,8 @@ description: "Prepare repository-local execution tools when the user requests se ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + 1. [LOAD IF NOT ACTIVE] `subagents-orchestration-guide` — capability failure resolution and caller-return rules ## Purpose diff --git a/.agents/skills/recipe-quality-profile/SKILL.md b/.agents/skills/recipe-quality-profile/SKILL.md index 3276184..69f2605 100644 --- a/.agents/skills/recipe-quality-profile/SKILL.md +++ b/.agents/skills/recipe-quality-profile/SKILL.md @@ -5,6 +5,8 @@ description: "Proposes and, after user confirmation, creates or maintains docs/p ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + 1. `llm-friendly-context` — make each generated condition unambiguous, executable, and observable 2. `coding-rules` — distinguish repository-specific policy from general code quality knowledge diff --git a/.agents/skills/recipe-reverse-engineer/SKILL.md b/.agents/skills/recipe-reverse-engineer/SKILL.md index 8c5f455..c5ea358 100644 --- a/.agents/skills/recipe-reverse-engineer/SKILL.md +++ b/.agents/skills/recipe-reverse-engineer/SKILL.md @@ -5,6 +5,8 @@ description: "Generate PRD and Design Docs from existing codebase through discov ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + 1. [LOAD IF NOT ACTIVE] `documentation-criteria` — document creation rules and templates 2. [LOAD IF NOT ACTIVE] `ai-development-guide` — evidence and completeness discipline 3. [LOAD IF NOT ACTIVE] `subagents-orchestration-guide` — agent coordination and review resolution diff --git a/.agents/skills/recipe-review/SKILL.md b/.agents/skills/recipe-review/SKILL.md index 115196d..f0421de 100644 --- a/.agents/skills/recipe-review/SKILL.md +++ b/.agents/skills/recipe-review/SKILL.md @@ -5,6 +5,8 @@ description: "Reviews completed implementation for governing-source compliance, ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + 1. [LOAD IF NOT ACTIVE] `coding-rules` — repository implementation rules 2. [LOAD IF NOT ACTIVE] `testing` — verification and test quality rules 3. [LOAD IF NOT ACTIVE] `ai-development-guide` — review and repair discipline diff --git a/.agents/skills/recipe-update-doc/SKILL.md b/.agents/skills/recipe-update-doc/SKILL.md index cd74e65..bfadffb 100644 --- a/.agents/skills/recipe-update-doc/SKILL.md +++ b/.agents/skills/recipe-update-doc/SKILL.md @@ -5,6 +5,8 @@ description: "Update existing design documents (Design Doc / PRD / ADR) with rev ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + 1. [LOAD IF NOT ACTIVE] `documentation-criteria` — document creation rules and templates 2. [LOAD IF NOT ACTIVE] `subagents-orchestration-guide` — agent coordination and workflow flows 3. [LOAD IF NOT ACTIVE] `llm-friendly-context` — document update and review handoffs diff --git a/.codex/agents/acceptance-test-generator.toml b/.codex/agents/acceptance-test-generator.toml index 3411cbc..c8be7dc 100644 --- a/.codex/agents/acceptance-test-generator.toml +++ b/.codex/agents/acceptance-test-generator.toml @@ -6,6 +6,8 @@ You generate a minimal set of integration/E2E test skeletons, which may be empty ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `testing`, `documentation-criteria`, `integration-e2e-testing`, `llm-friendly-context`. **Decision purpose**: Deliver the user-required result with the least justified complexity. Unnecessary mechanisms create implementation, test, and maintenance obligations. Question previously passed technical means; preserve user outcomes, explicit constraints, and actual consumer contracts. Consider no change, subtraction, and reuse before repair. Complete applicable dependencies and required proof before declaring completion. diff --git a/.codex/agents/code-reviewer.toml b/.codex/agents/code-reviewer.toml index 7127171..e15c84d 100644 --- a/.codex/agents/code-reviewer.toml +++ b/.codex/agents/code-reviewer.toml @@ -7,6 +7,8 @@ You review repository changes for the required outcome, justified complexity, an ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `ai-development-guide`, `coding-rules`, `testing`. **Decision purpose**: Deliver the user-required result with the least justified complexity. Unnecessary mechanisms create implementation, test, and maintenance obligations. Question previously passed technical means; preserve user outcomes, explicit constraints, and actual consumer contracts. Consider no change, subtraction, and reuse before repair. Complete applicable dependencies and required proof before declaring completion. diff --git a/.codex/agents/code-verifier.toml b/.codex/agents/code-verifier.toml index 9da4fc5..3a55e8c 100644 --- a/.codex/agents/code-verifier.toml +++ b/.codex/agents/code-verifier.toml @@ -9,6 +9,8 @@ Your discrepancies are independent facts for orchestrator Resolution. User-requi ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `documentation-criteria`, `ai-development-guide`, `coding-rules`. ## Inputs diff --git a/.codex/agents/codebase-analyzer.toml b/.codex/agents/codebase-analyzer.toml index 1d640c4..db3b9d6 100644 --- a/.codex/agents/codebase-analyzer.toml +++ b/.codex/agents/codebase-analyzer.toml @@ -9,6 +9,8 @@ Reduce unnecessary implementation: inspect the direct path and opportunities for ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `llm-friendly-context`. ## Input Parameters diff --git a/.codex/agents/design-sync.toml b/.codex/agents/design-sync.toml index 030552f..4f0e816 100644 --- a/.codex/agents/design-sync.toml +++ b/.codex/agents/design-sync.toml @@ -7,6 +7,8 @@ You are an AI assistant specializing in consistency verification between Design ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `documentation-criteria`, `coding-rules`, `llm-friendly-context`. Operates in an independent context, executing autonomously until task completion. diff --git a/.codex/agents/document-reviewer.toml b/.codex/agents/document-reviewer.toml index 3df57ca..c891eeb 100644 --- a/.codex/agents/document-reviewer.toml +++ b/.codex/agents/document-reviewer.toml @@ -7,6 +7,8 @@ You review one PRD, UI Spec, Design Doc, Work Plan, or one complete ADR batch pe ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `documentation-criteria`, `requirement-convergence`, `coding-rules`, `testing`, `llm-friendly-context`. **Decision purpose**: Prevent unnecessary implementation obligations while preserving the user-required result. Evaluate necessity and lifecycle value before internal consistency. Remove or narrow unsupported means even when upstream documents passed; return the affected source and smallest correction to the parent. New requirements require a user decision only when current conditions cannot deliver the requested result. diff --git a/.codex/agents/integration-test-reviewer.toml b/.codex/agents/integration-test-reviewer.toml index 660e49c..64fb524 100644 --- a/.codex/agents/integration-test-reviewer.toml +++ b/.codex/agents/integration-test-reviewer.toml @@ -9,6 +9,8 @@ Prevent unnecessary proof machinery: a passed design or skeleton does not make i ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `testing`, `integration-e2e-testing`. ## Rerun Boundary diff --git a/.codex/agents/investigator.toml b/.codex/agents/investigator.toml index 85789e5..15ba11f 100644 --- a/.codex/agents/investigator.toml +++ b/.codex/agents/investigator.toml @@ -7,6 +7,8 @@ You are an AI assistant specializing in problem investigation. ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `ai-development-guide`, `coding-rules`. **Evidence purpose**: Give the next decision enough evidence to avoid unnecessary implementation, test, and maintenance work. Report facts faithfully, including evidence against previously passed technical assumptions. A mechanism's existence or feasibility does not establish its necessity. Stay within the assigned investigation or verification boundary; leave solution selection to its owner. diff --git a/.codex/agents/prd-creator.toml b/.codex/agents/prd-creator.toml index 2108473..6652bb4 100644 --- a/.codex/agents/prd-creator.toml +++ b/.codex/agents/prd-creator.toml @@ -6,6 +6,8 @@ You create or update one PRD per invocation. ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `documentation-criteria`, `requirement-convergence`, `llm-friendly-context`. **Decision purpose**: Deliver the user-required result with the least justified complexity; unnecessary mechanisms create downstream implementation, test, and maintenance obligations. Establish necessity before detailing a mechanism. Previously passed technical choices remain revisable; preserve user outcomes and explicit constraints. Complete the required proof, then stop. diff --git a/.codex/agents/quality-fixer-frontend.toml b/.codex/agents/quality-fixer-frontend.toml index 114e8fd..27820e0 100644 --- a/.codex/agents/quality-fixer-frontend.toml +++ b/.codex/agents/quality-fixer-frontend.toml @@ -6,6 +6,8 @@ You own self-contained quality assurance and repair for one frontend implementat ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `coding-rules`, `testing`, `ai-development-guide`. When task verification cites a recorded external resource, also load `external-resource-context` before consulting it. diff --git a/.codex/agents/quality-fixer.toml b/.codex/agents/quality-fixer.toml index 111e3d6..839d876 100644 --- a/.codex/agents/quality-fixer.toml +++ b/.codex/agents/quality-fixer.toml @@ -6,6 +6,8 @@ You own self-contained quality assurance and repair for one implementation task. ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `coding-rules`, `testing`, `ai-development-guide`. When task verification cites a recorded external resource, also load `external-resource-context` before consulting it. diff --git a/.codex/agents/requirement-analyzer.toml b/.codex/agents/requirement-analyzer.toml index 4832a46..a0fbf91 100644 --- a/.codex/agents/requirement-analyzer.toml +++ b/.codex/agents/requirement-analyzer.toml @@ -7,6 +7,8 @@ You collect decision materials for the orchestrator's requirement confirmation a ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `ai-development-guide`, `llm-friendly-context`. **Decision purpose**: Deliver the user-required result with the least justified complexity; unnecessary mechanisms create downstream implementation, test, and maintenance obligations. Establish necessity before detailing a mechanism. Previously passed technical choices remain revisable; preserve user outcomes and explicit constraints. Complete the required proof, then stop. diff --git a/.codex/agents/scope-discoverer.toml b/.codex/agents/scope-discoverer.toml index 57a126e..3d01d8c 100644 --- a/.codex/agents/scope-discoverer.toml +++ b/.codex/agents/scope-discoverer.toml @@ -7,6 +7,8 @@ You are an AI assistant specializing in codebase scope discovery for reverse doc ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `documentation-criteria`, `ai-development-guide`, `coding-rules`, `implementation-approach`, `llm-friendly-context`. **Evidence purpose**: Give the next decision enough evidence to avoid unnecessary implementation, test, and maintenance work. Report facts faithfully, including evidence against previously passed technical assumptions. A mechanism's existence or feasibility does not establish its necessity. Stay within the assigned investigation or verification boundary; leave solution selection to its owner. diff --git a/.codex/agents/security-reviewer.toml b/.codex/agents/security-reviewer.toml index dc9a8a8..cab726e 100644 --- a/.codex/agents/security-reviewer.toml +++ b/.codex/agents/security-reviewer.toml @@ -9,6 +9,8 @@ Protect the required outcome with the smallest sufficient change. Consider remov ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `coding-rules`. ## Rerun Boundary diff --git a/.codex/agents/solver.toml b/.codex/agents/solver.toml index 7515f37..f098081 100644 --- a/.codex/agents/solver.toml +++ b/.codex/agents/solver.toml @@ -7,6 +7,8 @@ You are an AI assistant specializing in solution derivation. ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `ai-development-guide`, `coding-rules`, `implementation-approach`. **Decision purpose**: Deliver the user-required result with the least justified complexity. Unnecessary mechanisms create implementation, test, and maintenance obligations. Question previously passed technical means; preserve user outcomes, explicit constraints, and actual consumer contracts. Consider no change, subtraction, and reuse before repair. Complete applicable dependencies and required proof before declaring completion. diff --git a/.codex/agents/task-decomposer.toml b/.codex/agents/task-decomposer.toml index 1778427..4eae698 100644 --- a/.codex/agents/task-decomposer.toml +++ b/.codex/agents/task-decomposer.toml @@ -6,6 +6,8 @@ You convert an approved Work Plan into executable task files while preserving it ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `ai-development-guide`, `testing`, `coding-rules`, `implementation-approach`, `llm-friendly-context`. **Decision purpose**: Deliver the user-required result with the least justified complexity. Unnecessary mechanisms create implementation, test, and maintenance obligations. Question previously passed technical means; preserve user outcomes, explicit constraints, and actual consumer contracts. Consider no change, subtraction, and reuse before repair. Complete applicable dependencies and required proof before declaring completion. diff --git a/.codex/agents/task-executor-frontend.toml b/.codex/agents/task-executor-frontend.toml index 1bdbe5d..ed32e3a 100644 --- a/.codex/agents/task-executor-frontend.toml +++ b/.codex/agents/task-executor-frontend.toml @@ -6,6 +6,8 @@ You are a specialized AI assistant for reliably executing frontend implementatio ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `coding-rules`, `testing`, `ai-development-guide`, `implementation-approach`. When the task cites a recorded external resource, also load `external-resource-context` before consulting it. diff --git a/.codex/agents/task-executor.toml b/.codex/agents/task-executor.toml index 3789b53..cfcbdd6 100644 --- a/.codex/agents/task-executor.toml +++ b/.codex/agents/task-executor.toml @@ -6,6 +6,8 @@ You are a specialized AI assistant for reliably executing individual tasks. ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `coding-rules`, `testing`, `ai-development-guide`, `implementation-approach`. When the task cites a recorded external resource, also load `external-resource-context` before consulting it. diff --git a/.codex/agents/technical-designer-frontend.toml b/.codex/agents/technical-designer-frontend.toml index 740b816..e996cd9 100644 --- a/.codex/agents/technical-designer-frontend.toml +++ b/.codex/agents/technical-designer-frontend.toml @@ -6,6 +6,8 @@ You create one complete frontend ADR batch or one frontend Design Doc per invoca ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `documentation-criteria`, `requirement-convergence`, `coding-rules`, `testing`, `ai-development-guide`, `implementation-approach`, `llm-friendly-context`. **Decision purpose**: Deliver the user-required result with the least justified complexity; unnecessary mechanisms create downstream implementation, test, and maintenance obligations. Establish necessity before detailing a mechanism. Previously passed technical choices remain revisable; preserve user outcomes and explicit constraints. Complete the required proof, then stop. diff --git a/.codex/agents/technical-designer.toml b/.codex/agents/technical-designer.toml index b17cf65..33f7f22 100644 --- a/.codex/agents/technical-designer.toml +++ b/.codex/agents/technical-designer.toml @@ -6,6 +6,8 @@ You create one complete ADR batch or one Design Doc per invocation. ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `documentation-criteria`, `requirement-convergence`, `coding-rules`, `testing`, `ai-development-guide`, `implementation-approach`, `llm-friendly-context`. **Decision purpose**: Deliver the user-required result with the least justified complexity; unnecessary mechanisms create downstream implementation, test, and maintenance obligations. Establish necessity before detailing a mechanism. Previously passed technical choices remain revisable; preserve user outcomes and explicit constraints. Complete the required proof, then stop. diff --git a/.codex/agents/technical-spike.toml b/.codex/agents/technical-spike.toml index 7036063..de5f62b 100644 --- a/.codex/agents/technical-spike.toml +++ b/.codex/agents/technical-spike.toml @@ -7,6 +7,8 @@ Measure one design-changing technical effect or cost with a bounded disposable p ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `ai-development-guide`, `testing`. ## Input diff --git a/.codex/agents/ui-analyzer.toml b/.codex/agents/ui-analyzer.toml index a29439a..3ca70ea 100644 --- a/.codex/agents/ui-analyzer.toml +++ b/.codex/agents/ui-analyzer.toml @@ -7,6 +7,8 @@ Gather UI evidence for the supplied design or adjustment questions. Keep reposit ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `llm-friendly-context`. Load `external-resource-context` only for supplied external references; use its Lookup Protocol. diff --git a/.codex/agents/ui-spec-designer.toml b/.codex/agents/ui-spec-designer.toml index 53242dd..ba3a0fd 100644 --- a/.codex/agents/ui-spec-designer.toml +++ b/.codex/agents/ui-spec-designer.toml @@ -6,6 +6,8 @@ You create one UI Specification for the confirmed frontend outcome. ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `documentation-criteria`, `coding-rules`, `llm-friendly-context`. Load `external-resource-context` only when the supplied UI Analysis or current decision cites a recorded external resource that must be consulted. diff --git a/.codex/agents/verifier.toml b/.codex/agents/verifier.toml index 31cd41c..8ddf5b3 100644 --- a/.codex/agents/verifier.toml +++ b/.codex/agents/verifier.toml @@ -7,6 +7,8 @@ You are an AI assistant specializing in investigation result verification. ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `ai-development-guide`, `coding-rules`. **Evidence purpose**: Give the next decision enough evidence to avoid unnecessary implementation, test, and maintenance work. Report facts faithfully, including evidence against previously passed technical assumptions. A mechanism's existence or feasibility does not establish its necessity. Stay within the assigned investigation or verification boundary; leave solution selection to its owner. diff --git a/.codex/agents/work-planner.toml b/.codex/agents/work-planner.toml index f962925..d76d13a 100644 --- a/.codex/agents/work-planner.toml +++ b/.codex/agents/work-planner.toml @@ -6,6 +6,8 @@ You create Work Plans that translate approved Design Docs into executable reposi ## Required Skills [LOAD BEFORE EXECUTION] +Before loading required skills, use `wc -c` to size the files and set both `exec_command.max_output_tokens` and the outer `// @exec: {"max_output_tokens": N}` budget to accommodate their contents, including the combined output of batched reads. Split oversized reads upfront; recover any truncated content before proceeding. + Load and read each skill completely before taking task actions: `ai-development-guide`, `documentation-criteria`, `coding-rules`, `testing`, `implementation-approach`, `llm-friendly-context`. **Decision purpose**: Deliver the user-required result with the least justified complexity; unnecessary mechanisms create downstream implementation, test, and maintenance obligations. Establish necessity before detailing a mechanism. Previously passed technical choices remain revisable; preserve user outcomes and explicit constraints. Complete the required proof, then stop. diff --git a/package.json b/package.json index 9d9adeb..68189ad 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "codex-workflows", - "version": "1.8.4", + "version": "1.8.5", "description": "Codex CLI workflows that keep larger software changes within the approved scope, from planning through review", "license": "MIT", "author": "Shinsuke Kagawa",