specdojo 0.4.5 → 0.4.7

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.
Files changed (101) hide show
  1. package/.github/agents/specdojo-orchestrator.md +4 -4
  2. package/CHANGELOG.md +41 -0
  3. package/dist/catalog/document-target.js +75 -0
  4. package/dist/commands/agent.js +2 -80
  5. package/dist/commands/init.js +33 -7
  6. package/dist/devcontainer/scaffold.js +5 -1
  7. package/dist/exec/agent-config.js +28 -16
  8. package/dist/exec/agent-plan.js +108 -0
  9. package/dist/exec/commands.js +3 -3
  10. package/dist/exec/evidence.js +35 -3
  11. package/dist/exec/grade-checkpoint.js +12 -0
  12. package/dist/exec/pipeline-state.js +1 -0
  13. package/dist/exec/plans-core.js +11 -67
  14. package/dist/exec/plans-generation.js +22 -5
  15. package/dist/exec/project.js +4 -1
  16. package/dist/exec/register-resume.js +8 -4
  17. package/dist/exec/register.js +66 -5
  18. package/dist/exec/reporter.js +8 -1
  19. package/dist/exec/results.js +1 -1
  20. package/dist/exec/run/agent-pipeline.js +7 -5
  21. package/dist/exec/run/agent.js +14 -1
  22. package/dist/exec/run/lifecycle-commands.js +2 -0
  23. package/dist/exec/run/register-resume.js +2 -0
  24. package/dist/exec/run/register-state.js +4 -1
  25. package/dist/exec/run/register-worktree.js +8 -1
  26. package/dist/exec/run/schedule-prepare.js +7 -1
  27. package/dist/exec/worktree-command.js +8 -1
  28. package/dist/exec/worktree-ops-lifecycle.js +4 -2
  29. package/dist/exec/worktree-ops-merge.js +40 -1
  30. package/dist/grade/apply.js +7 -5
  31. package/dist/grade/command-inspect.js +2 -1
  32. package/dist/grade/command-run.js +39 -0
  33. package/dist/grade/grade.js +3 -1
  34. package/dist/grade/markdown.js +4 -4
  35. package/dist/grade/pipeline-state.js +8 -6
  36. package/dist/grade/plan.js +8 -6
  37. package/dist/grade/run.js +307 -0
  38. package/dist/grade/target-discovery.js +1 -1
  39. package/dist/grade/targets.js +44 -22
  40. package/dist/kata/command.js +54 -9
  41. package/dist/register/approach.js +16 -0
  42. package/dist/register/core.js +2 -0
  43. package/dist/register/create-commands.js +57 -7
  44. package/dist/register/deliverable-target.js +215 -0
  45. package/dist/register/events.js +4 -0
  46. package/dist/register/external-project.js +18 -7
  47. package/dist/register/item.js +8 -0
  48. package/dist/register/views.js +3 -0
  49. package/dist/review/grade.js +19 -17
  50. package/dist/shared/agent-plan.js +1 -0
  51. package/dist/shared/git.js +3 -2
  52. package/dist/shared/lefthook-scaffold.js +5 -22
  53. package/dist/shared/markdownlint-scaffold.js +67 -0
  54. package/dist/shared/provider-scaffold.js +7 -5
  55. package/dist/shared/slidev-scaffold.js +102 -0
  56. package/dist/shared/specdojo-config.js +9 -3
  57. package/dist/specdojo.js +5 -1
  58. package/docs/ja/specdojo/exec-templates/xep-register-template.md +5 -4
  59. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +2 -2
  60. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +2 -2
  61. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +2 -2
  62. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +2 -2
  63. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +2 -2
  64. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +2 -2
  65. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +2 -2
  66. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +2 -2
  67. package/docs/ja/specdojo/exec-templates/xrp-template.md +2 -2
  68. package/docs/ja/specdojo/guides/exec-config-guide.md +81 -19
  69. package/docs/ja/specdojo/guides/exec-operation-guide.md +4 -0
  70. package/docs/ja/specdojo/guides/kata-guide.md +108 -1
  71. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +6 -6
  72. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +3 -1
  73. package/docs/ja/specdojo/guides/quick-start-guide.md +22 -2
  74. package/docs/ja/specdojo/guides/register-operation-guide.md +2 -0
  75. package/docs/ja/specdojo/guides/remote-host-development-guide.md +15 -1
  76. package/docs/ja/specdojo/guides/review-guide.md +2 -2
  77. package/docs/ja/specdojo/guides/ryu-guide.md +12 -0
  78. package/docs/ja/specdojo/references/command-reference.md +178 -62
  79. package/docs/ja/specdojo/references/specdojo-config-reference.md +31 -8
  80. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +28 -22
  81. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +17 -1
  82. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  83. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  84. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +33 -1
  85. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +16 -3
  86. package/package.json +5 -5
  87. package/templates/antigravity/orchestrator.md +4 -4
  88. package/templates/claude/README.md +2 -0
  89. package/templates/claude/agents/specdojo-orchestrator.md +4 -4
  90. package/templates/codex/README.md +38 -9
  91. package/templates/codex/agents/codex-executor.toml +1 -1
  92. package/templates/codex/agents/codex-expert-executor.toml +1 -1
  93. package/templates/codex/agents/codex-expert-review-executor.toml +1 -1
  94. package/templates/codex/agents/codex-review-executor.toml +1 -1
  95. package/templates/codex/agents/specdojo-orchestrator.toml +5 -5
  96. package/templates/codex/orchestrator.md +4 -4
  97. package/templates/devcontainer/devcontainer.json +1 -0
  98. package/templates/init-agent-members.yaml +131 -16
  99. package/templates/opencode/README.md +118 -14
  100. package/templates/opencode/agents/specdojo-orchestrator.md +5 -5
  101. package/templates/opencode/opencode.json +25 -0
@@ -0,0 +1,67 @@
1
+ import { existsSync } from "node:fs";
2
+ import { readdir, writeFile } from "node:fs/promises";
3
+ import path from "node:path";
4
+ import { dump } from "js-yaml";
5
+ const BASE_CONFIG = {
6
+ MD013: false,
7
+ MD024: false,
8
+ MD033: false,
9
+ MD036: false,
10
+ MD041: false,
11
+ MD060: false,
12
+ };
13
+ // Slide boundaries and per-slide frontmatter interrupt normal Markdown blocks.
14
+ // Each slide may start with its own H1 or use a heading level chosen for its layout.
15
+ const SLIDEV_CONFIG = {
16
+ MD001: false,
17
+ MD022: false,
18
+ MD025: false,
19
+ MD031: false,
20
+ MD032: false,
21
+ };
22
+ export async function writeMarkdownlintConfigs(opts) {
23
+ const files = await readdir(opts.repoRoot);
24
+ const legacyConfigs = files.filter((file) => file.startsWith(".markdownlint."));
25
+ const cli2Configs = files.filter((file) => file.startsWith(".markdownlint-cli2."));
26
+ const hasRc = existsSync(path.join(opts.repoRoot, ".markdownlintrc"));
27
+ const rcContent = `${JSON.stringify(BASE_CONFIG, null, 2)}\n`;
28
+ const cli2Content = dump({
29
+ config: { extends: ".markdownlintrc" },
30
+ ...(opts.slidevKataPatterns?.length
31
+ ? {
32
+ overrides: [{ filter: opts.slidevKataPatterns, combine: "merge", config: SLIDEV_CONFIG }],
33
+ }
34
+ : {}),
35
+ });
36
+ process.stdout.write(`Planned markdownlint base (.markdownlintrc):\n${rcContent}` +
37
+ `Planned markdownlint-cli2 configuration (.markdownlint-cli2.yaml):\n${cli2Content}`);
38
+ if (opts.slidevKataPatterns?.length) {
39
+ process.stdout.write("Place the Slidev override FIRST in markdownlint-cli2 overrides (first match wins).\n");
40
+ }
41
+ if (legacyConfigs.length > 0) {
42
+ process.stdout.write(`Kept existing markdownlint config: ${legacyConfigs.join(", ")}.\n` +
43
+ "Migrate its rules to .markdownlintrc (JSON starting with {, without a leading comment), " +
44
+ "then remove the old .markdownlint.* config, including any in parent directories. " +
45
+ "Merge the CLI2 configuration above manually; see docs/ja/specdojo/references/command-reference.md.\n");
46
+ }
47
+ // Do not introduce competing settings or an extends pointing to a missing rc.
48
+ // Existing CLI2 configurations may have their own base; show additions for manual review.
49
+ const canCreateRc = legacyConfigs.length === 0 && cli2Configs.length === 0;
50
+ const canCreateCli2 = legacyConfigs.length === 0 && (hasRc || canCreateRc);
51
+ for (const [filename, content, canCreate] of [
52
+ [".markdownlintrc", rcContent, canCreateRc],
53
+ [".markdownlint-cli2.yaml", cli2Content, canCreateCli2],
54
+ ]) {
55
+ const existing = filename === ".markdownlintrc" ? hasRc : cli2Configs.length > 0;
56
+ if (existing || !canCreate) {
57
+ process.stdout.write(`Kept existing markdownlint settings. Merge any missing ${filename} entries above manually.\n`);
58
+ }
59
+ else if (opts.dryRun) {
60
+ process.stdout.write(`[dry-run] would write: ${filename}\n`);
61
+ }
62
+ else {
63
+ await writeFile(path.join(opts.repoRoot, filename), content, "utf8");
64
+ process.stdout.write(`Written: ${filename}\n`);
65
+ }
66
+ }
67
+ }
@@ -12,8 +12,8 @@ export const ORCHESTRATOR_NPM_SCRIPTS = {
12
12
  "orch:sonnet": "specdojo orchestrator launch --provider claude -- --agent specdojo-orchestrator --model sonnet --settings .specdojo/claude/settings.orchestrator.json",
13
13
  },
14
14
  codex: {
15
- "orch:sol": 'specdojo orchestrator launch --provider codex -- -m gpt-5.6-sol "$(cat .specdojo/codex/orchestrator.md)"',
16
- "orch:terra": 'specdojo orchestrator launch --provider codex -- -m gpt-5.6-terra "$(cat .specdojo/codex/orchestrator.md)"',
15
+ "orch:sol": 'specdojo orchestrator launch --provider codex -- -m gpt-6.1-sol "$(cat .specdojo/codex/orchestrator.md)"',
16
+ "orch:luna": 'specdojo orchestrator launch --provider codex -- -m gpt-6-luna "$(cat .specdojo/codex/orchestrator.md)"',
17
17
  },
18
18
  antigravity: {
19
19
  "orch:flash": 'specdojo orchestrator launch --provider antigravity -- --add-dir "$(pwd)" --model gemini-3.8-flash-high -i "$(cat .specdojo/antigravity/orchestrator.md)"',
@@ -75,9 +75,11 @@ export async function buildProviderScaffoldPlan(opts) {
75
75
  relFile === PROVIDER_GLOBAL_SETTINGS[provider]?.templateRelPath) {
76
76
  continue;
77
77
  }
78
- const destinationRelPath = relFile.startsWith("agents/") || relFile.startsWith("rules/")
79
- ? `.${provider}/${relFile}`
80
- : `.specdojo/${provider}/${relFile}`;
78
+ const destinationRelPath = provider === "opencode" && relFile === "opencode.json"
79
+ ? "opencode.json"
80
+ : relFile.startsWith("agents/") || relFile.startsWith("rules/")
81
+ ? `.${provider}/${relFile}`
82
+ : `.specdojo/${provider}/${relFile}`;
81
83
  entries.push({
82
84
  sourcePath: path.join(templateDir, ...relFile.split("/")),
83
85
  destinationPath: path.join(repoRoot, ...destinationRelPath.split("/")),
@@ -0,0 +1,102 @@
1
+ import { existsSync } from "node:fs";
2
+ import { readFile, writeFile } from "node:fs/promises";
3
+ import path from "node:path";
4
+ import { writeMarkdownlintConfigs } from "./markdownlint-scaffold.js";
5
+ // Keep ordinary kata Markdown on the standard parser. Existing decks with other
6
+ // names can be added to the displayed overrides and ignore patterns by the user.
7
+ export const SLIDEV_KATA_PATTERNS = [
8
+ "docs/ja/specdojo/samples/**/*-slidev-sample.md",
9
+ "docs/ja/specdojo/templates/**/*-slidev-template.md",
10
+ ];
11
+ const DEV_DEPENDENCIES = {
12
+ "@slidev/cli": "^53.0.0",
13
+ "prettier-plugin-slidev": "^1.0.5",
14
+ prettier: "^3.8.4",
15
+ };
16
+ const PRETTIER_CONFIG = {
17
+ overrides: [
18
+ {
19
+ files: SLIDEV_KATA_PATTERNS,
20
+ options: { parser: "slidev", plugins: ["prettier-plugin-slidev"] },
21
+ },
22
+ ],
23
+ };
24
+ const PRETTIER_CONFIG_FILES = [
25
+ ".prettierrc",
26
+ ...["json", "json5", "yml", "yaml", "js", "ts", "mjs", "mts", "cjs", "cts", "toml"].map((extension) => `.prettierrc.${extension}`),
27
+ ...["js", "ts", "mjs", "mts", "cjs", "cts"].map((extension) => `prettier.config.${extension}`),
28
+ ];
29
+ function isRecord(value) {
30
+ return typeof value === "object" && value !== null && !Array.isArray(value);
31
+ }
32
+ export async function runSlidevScaffold(opts) {
33
+ const packagePath = path.join(opts.repoRoot, "package.json");
34
+ const packageContent = existsSync(packagePath) ? await readFile(packagePath, "utf8") : undefined;
35
+ const parsed = packageContent === undefined ? {} : JSON.parse(packageContent);
36
+ if (!isRecord(parsed))
37
+ throw new Error(`Invalid ${packagePath}: expected an object`);
38
+ for (const field of ["dependencies", "devDependencies"]) {
39
+ if (parsed[field] !== undefined && !isRecord(parsed[field])) {
40
+ throw new Error(`Invalid ${packagePath}: ${field} must be an object`);
41
+ }
42
+ }
43
+ const dependencies = isRecord(parsed.dependencies) ? parsed.dependencies : {};
44
+ const devDependencies = isRecord(parsed.devDependencies) ? parsed.devDependencies : {};
45
+ const additions = Object.fromEntries(Object.entries(DEV_DEPENDENCIES).filter(([name]) => !Object.hasOwn(dependencies, name) && !Object.hasOwn(devDependencies, name)));
46
+ process.stdout.write(`Planned package.json additions (Slidev):\n${JSON.stringify({ devDependencies: additions }, null, 2)}\n`);
47
+ for (const name of Object.keys(DEV_DEPENDENCIES)) {
48
+ if (Object.hasOwn(dependencies, name) || Object.hasOwn(devDependencies, name)) {
49
+ process.stdout.write(`Skipped (dependency already exists): ${name} in package.json\n`);
50
+ }
51
+ }
52
+ if (packageContent === undefined) {
53
+ process.stdout.write("Skipped package.json update (not found). Create it and add the entries above.\n");
54
+ }
55
+ const prettierConfig = Object.hasOwn(parsed, "prettier")
56
+ ? "package.json#prettier"
57
+ : PRETTIER_CONFIG_FILES.find((file) => existsSync(path.join(opts.repoRoot, file)));
58
+ const prettierContent = `${JSON.stringify(PRETTIER_CONFIG, null, 2)}\n`;
59
+ process.stdout.write(`Planned Slidev Prettier overrides:\n${prettierContent}`);
60
+ if (prettierConfig) {
61
+ process.stdout.write(`Kept existing ${prettierConfig}. Merge the overrides above manually for your Slidev kata paths.\n`);
62
+ }
63
+ const ignorePath = path.join(opts.repoRoot, ".markdownlintignore");
64
+ const ignoreExists = existsSync(ignorePath);
65
+ const ignoreContent = `${SLIDEV_KATA_PATTERNS.join("\n")}\n`;
66
+ process.stdout.write(`Planned Slidev .markdownlintignore entries:\n${ignoreContent}`);
67
+ if (ignoreExists) {
68
+ process.stdout.write("Kept existing .markdownlintignore. Add any missing patterns above manually.\n");
69
+ }
70
+ process.stdout.write("Place the Slidev override LAST in Prettier overrides (last match wins).\n");
71
+ await writeMarkdownlintConfigs({ ...opts, slidevKataPatterns: SLIDEV_KATA_PATTERNS });
72
+ // Preview all additions before the first write, including on a normal run.
73
+ if (opts.dryRun) {
74
+ if (packageContent !== undefined && Object.keys(additions).length > 0) {
75
+ process.stdout.write("[dry-run] would update: package.json\n");
76
+ }
77
+ if (!prettierConfig)
78
+ process.stdout.write("[dry-run] would write: .prettierrc\n");
79
+ if (!ignoreExists)
80
+ process.stdout.write("[dry-run] would write: .markdownlintignore\n");
81
+ return;
82
+ }
83
+ if (packageContent !== undefined && Object.keys(additions).length > 0) {
84
+ parsed.devDependencies = { ...devDependencies, ...additions };
85
+ const indent = packageContent.match(/^([\t ]+)\S/m)?.[1] ?? " ";
86
+ await writeFile(packagePath, `${JSON.stringify(parsed, null, indent)}\n`, "utf8");
87
+ process.stdout.write("Updated: package.json\n");
88
+ }
89
+ if (!prettierConfig) {
90
+ await writeFile(path.join(opts.repoRoot, ".prettierrc"), prettierContent, "utf8");
91
+ process.stdout.write("Written: .prettierrc\n");
92
+ }
93
+ if (!ignoreExists) {
94
+ await writeFile(ignorePath, ignoreContent, "utf8");
95
+ process.stdout.write("Written: .markdownlintignore\n");
96
+ }
97
+ process.stdout.write("Next steps (Slidev):\n" +
98
+ " 1. Review the additions and any manual merges above, then run npm install.\n" +
99
+ " 2. Install the theme used by the kata and supply its project-specific components/assets.\n" +
100
+ ' 3. Run ./node_modules/.bin/slidev build <kata-sample.md> --out "$PWD/tmp/slidev-dist".\n' +
101
+ " See docs/ja/specdojo/guides/kata-guide.md for the verification workflow.\n");
102
+ }
@@ -6,6 +6,7 @@ import Ajv2020Module from "ajv/dist/2020.js";
6
6
  import { runProviderScaffold, specdojoPackageRootDir } from "./provider-scaffold.js";
7
7
  import { runWorkspaceScaffold } from "./workspace-scaffold.js";
8
8
  import { runLefthookScaffold } from "./lefthook-scaffold.js";
9
+ import { runSlidevScaffold, SLIDEV_KATA_PATTERNS } from "./slidev-scaffold.js";
9
10
  import { ensureGitignore, formatGitignoreReport, gitignorePatternsForLayouts, } from "./specdojo-gitignore.js";
10
11
  /** Default IANA time zone for register date derivation when run.register_date_timezone is unset. */
11
12
  export const DEFAULT_REGISTER_DATE_TIMEZONE = "UTC";
@@ -786,18 +787,19 @@ export function registerConfigCommands(program) {
786
787
  });
787
788
  cfg
788
789
  .command("scaffold")
789
- .description("Scaffold provider settings, a VS Code multi-root workspace, or Git hooks")
790
+ .description("Scaffold provider settings, a VS Code multi-root workspace, Git hooks, or Slidev")
790
791
  .option("--provider <name>", "Provider template to copy (antigravity|claude|codex|copilot|opencode)")
791
792
  .option("--workspace", "Generate VS Code multi-root workspace (<project-id>.code-workspace) from repos config", false)
792
793
  .option("--lefthook", "Generate pre-commit hooks for SpecDojo repositories", false)
794
+ .option("--slidev", "Set up Slidev and formatting for kata", false)
793
795
  .option("--project <id>", "Target project ID for workspace scaffolding (defaults to current_project)")
794
796
  .option("--force", "Overwrite existing files", false)
795
797
  .option("--dry-run", "Show planned files without writing", false)
796
798
  .option("--global", "Merge provider permissions into user-level settings (currently antigravity only)", false)
797
799
  .action(async (opts) => {
798
800
  try {
799
- if (!opts.provider && !opts.workspace && !opts.lefthook) {
800
- throw new Error("Specify --provider <name>, --workspace, or --lefthook to scaffold.");
801
+ if (!opts.provider && !opts.workspace && !opts.lefthook && !opts.slidev) {
802
+ throw new Error("Specify --provider <name>, --workspace, --lefthook, or --slidev to scaffold.");
801
803
  }
802
804
  if (opts.global && !opts.provider) {
803
805
  throw new Error("--global requires --provider antigravity");
@@ -828,10 +830,14 @@ export function registerConfigCommands(program) {
828
830
  packageRoot: specdojoPackageRootDir(),
829
831
  repoRoot: specdojoRootDir(),
830
832
  config,
833
+ slidevKataPatterns: opts.slidev ? SLIDEV_KATA_PATTERNS : [],
831
834
  force: !!opts.force,
832
835
  dryRun: !!opts.dryRun,
833
836
  });
834
837
  }
838
+ if (opts.slidev) {
839
+ await runSlidevScaffold({ repoRoot: specdojoRootDir(), dryRun: !!opts.dryRun });
840
+ }
835
841
  }
836
842
  catch (error) {
837
843
  const message = error instanceof Error ? error.message : String(error);
package/dist/specdojo.js CHANGED
@@ -19,6 +19,7 @@ import { registerYamlPagesCommands } from "./docs/yaml-pages-command.js";
19
19
  import { registerDashboardCommands } from "./dashboard/dashboard.js";
20
20
  import { registerGradeCommand } from "./grade/grade.js";
21
21
  import { registerAgentCommands } from "./commands/agent.js";
22
+ import { resolveGradingPlanActor, runAgentPlan } from "./exec/agent-plan.js";
22
23
  import { registerKataCommands } from "./kata/command.js";
23
24
  import { registerDevcontainerCommands } from "./devcontainer/command.js";
24
25
  import { registerInitCommand } from "./commands/init.js";
@@ -58,7 +59,10 @@ async function main() {
58
59
  registerBuildCommand(program);
59
60
  registerYamlPagesCommands(program);
60
61
  registerDashboardCommands(program);
61
- registerGradeCommand(program);
62
+ registerGradeCommand(program, {
63
+ resolveActor: resolveGradingPlanActor,
64
+ executePlan: runAgentPlan,
65
+ });
62
66
  registerAgentCommands(program);
63
67
  registerKataCommands(program);
64
68
  registerDevcontainerCommands(program);
@@ -21,16 +21,17 @@ _PJR_DESCRIPTION_
21
21
  ## 3. 進め方
22
22
 
23
23
  1. 個票(存在する場合)を読み、目的・完了条件・制約を把握する。登録簿の一覧は大きいため読まない。
24
- 2. 個票に完了条件がある場合はそれを作業の基準にする。無い場合はタイトルと説明から完了条件の仮説を立て、その仮説を result に明記する。
24
+ 2. 個票に完了条件がある場合はそれを作業の基準にする。無い場合はタイトルと説明から完了条件の仮説を立て、記録する。pipeline では個票の対応結果と executor の報告の `handoff` に書き、result を直接書ける実行形式では result に明記する。
25
25
  3. 関連する成果物・設計書・実装を確認し、対象ファイルを特定して変更する。
26
26
  4. 個票が存在する場合は、個票の作業内容・対応結果セクションを実施内容で更新する。
27
- 5. 判断に迷う箇所は _TODO_ / _ASSUMPTION_ で残し、根拠と次のアクションを result に書く。
27
+ 5. 個票の完了条件が result への記載を求める場合、pipeline の executor は個票の対応結果と報告の `handoff` の両方に書く。reporter と runner が result の申し送りへ反映する。executor は result を直接編集しない。
28
+ 6. 判断に迷う箇所は _TODO_ / _ASSUMPTION_ で残し、根拠と次のアクションを記録する。pipeline では個票の対応結果と報告の `handoff` に書き、result を直接書ける実行形式では result に書く。
28
29
 
29
30
  ### grade result から展開された finding
30
31
 
31
32
  _GRADE_FINDINGS_
32
33
 
33
- plan に展開された finding は、message と同じ viewpoint ID の判定根拠に照らして解消する。未解消、根拠不足、または判断不能の場合は、理由と次のアクションを result に記録する。grade result サイドカーは再評価時に更新されるため、本タスクでは直接編集しない。
34
+ plan に展開された finding は、message と同じ viewpoint ID の判定根拠に照らして解消する。未解消、根拠不足、または判断不能の場合は、理由と次のアクションを記録する。pipeline では個票の対応結果と報告の `handoff` に書き、result を直接書ける実行形式では result に書く。grade result サイドカーは再評価時に更新されるため、本タスクでは直接編集しない。
34
35
 
35
36
  _AUTOPILOT_CONSTRAINTS_
36
37
 
@@ -38,7 +39,7 @@ _AUTOPILOT_CONSTRAINTS_
38
39
 
39
40
  1. 「進め方」に従って対応を完了する。
40
41
  2. 共通規約に従って、必要な整形・静的検査を実行する。
41
- 3. result に実施内容・変更ファイル・申し送りを記入する。これはタスク完了に必須であり、_TODO_ を残したまま終了しない(詳細は共通規約を参照)。
42
+ 3. result に実施内容・変更ファイル・申し送りを記入する。pipeline では executor は実施内容・変更ファイル・検証結果を報告し、申し送りを `handoff` に記載する。reporter と runner が result を記入する。これはタスク完了に必須であり、_TODO_ を残したまま終了しない(詳細は共通規約を参照)。
42
43
  4. 登録簿(`pjr-index.md`)の行と個票のステータス項目は変更しない。状態遷移(review / close など)は runner と人間が行う。
43
44
 
44
45
  ## 5. 異常終了の条件
@@ -34,8 +34,8 @@ _GRADE_SUMMARY_
34
34
  <!-- markdownlint-disable MD055 MD056 -->
35
35
 
36
36
  <!-- prettier-ignore-start -->
37
- | ID | ロール | viewpoint_id | 完了条件 |
38
- | --- | ------ | ------------ | -------- |
37
+ | ID | ロール | `viewpoint_id` | 完了条件 |
38
+ | --- | --- | --- | --- |
39
39
  _DONE_CRITERIA_ROWS_
40
40
  <!-- prettier-ignore-end -->
41
41
 
@@ -34,8 +34,8 @@ _GRADE_SUMMARY_
34
34
  <!-- markdownlint-disable MD055 MD056 -->
35
35
 
36
36
  <!-- prettier-ignore-start -->
37
- | ID | ロール | viewpoint_id | 完了条件 |
38
- | --- | ------ | ------------ | -------- |
37
+ | ID | ロール | `viewpoint_id` | 完了条件 |
38
+ | --- | --- | --- | --- |
39
39
  _DONE_CRITERIA_ROWS_
40
40
  <!-- prettier-ignore-end -->
41
41
 
@@ -34,8 +34,8 @@ _GRADE_SUMMARY_
34
34
  <!-- markdownlint-disable MD055 MD056 -->
35
35
 
36
36
  <!-- prettier-ignore-start -->
37
- | ID | ロール | viewpoint_id | 完了条件 |
38
- | --- | ------ | ------------ | -------- |
37
+ | ID | ロール | `viewpoint_id` | 完了条件 |
38
+ | --- | --- | --- | --- |
39
39
  _DONE_CRITERIA_ROWS_
40
40
  <!-- prettier-ignore-end -->
41
41
 
@@ -34,8 +34,8 @@ _GRADE_SUMMARY_
34
34
  <!-- markdownlint-disable MD055 MD056 -->
35
35
 
36
36
  <!-- prettier-ignore-start -->
37
- | ID | ロール | viewpoint_id | 完了条件 |
38
- | --- | ------ | ------------ | -------- |
37
+ | ID | ロール | `viewpoint_id` | 完了条件 |
38
+ | --- | --- | --- | --- |
39
39
  _DONE_CRITERIA_ROWS_
40
40
  <!-- prettier-ignore-end -->
41
41
 
@@ -40,8 +40,8 @@ _GRADE_SUMMARY_
40
40
  <!-- markdownlint-disable MD055 MD056 -->
41
41
 
42
42
  <!-- prettier-ignore-start -->
43
- | ID | ロール | viewpoint_id | 完了条件 |
44
- | --- | ------ | ------------ | -------- |
43
+ | ID | ロール | `viewpoint_id` | 完了条件 |
44
+ | --- | --- | --- | --- |
45
45
  _DONE_CRITERIA_ROWS_
46
46
  <!-- prettier-ignore-end -->
47
47
 
@@ -35,8 +35,8 @@ _GRADE_SUMMARY_
35
35
  <!-- markdownlint-disable MD055 MD056 -->
36
36
 
37
37
  <!-- prettier-ignore-start -->
38
- | ID | ロール | viewpoint_id | 完了条件 |
39
- | --- | ------ | ------------ | -------- |
38
+ | ID | ロール | `viewpoint_id` | 完了条件 |
39
+ | --- | --- | --- | --- |
40
40
  _DONE_CRITERIA_ROWS_
41
41
  <!-- prettier-ignore-end -->
42
42
 
@@ -34,8 +34,8 @@ _GRADE_SUMMARY_
34
34
  <!-- markdownlint-disable MD055 MD056 -->
35
35
 
36
36
  <!-- prettier-ignore-start -->
37
- | ID | ロール | viewpoint_id | 完了条件 |
38
- | --- | ------ | ------------ | -------- |
37
+ | ID | ロール | `viewpoint_id` | 完了条件 |
38
+ | --- | --- | --- | --- |
39
39
  _DONE_CRITERIA_ROWS_
40
40
  <!-- prettier-ignore-end -->
41
41
 
@@ -34,8 +34,8 @@ _GRADE_SUMMARY_
34
34
  <!-- markdownlint-disable MD055 MD056 -->
35
35
 
36
36
  <!-- prettier-ignore-start -->
37
- | ID | ロール | viewpoint_id | 完了条件 |
38
- | --- | ------ | ------------ | -------- |
37
+ | ID | ロール | `viewpoint_id` | 完了条件 |
38
+ | --- | --- | --- | --- |
39
39
  _DONE_CRITERIA_ROWS_
40
40
  <!-- prettier-ignore-end -->
41
41
 
@@ -35,8 +35,8 @@ _GRADE_SUMMARY_
35
35
  <!-- markdownlint-disable MD055 MD056 -->
36
36
 
37
37
  <!-- prettier-ignore-start -->
38
- | ID | ロール | viewpoint_id | 完了条件 |
39
- | --- | ------ | ------------ | -------- |
38
+ | ID | ロール | `viewpoint_id` | 完了条件 |
39
+ | --- | --- | --- | --- |
40
40
  _DONE_CRITERIA_ROWS_
41
41
  <!-- prettier-ignore-end -->
42
42
 
@@ -130,7 +130,7 @@ members:
130
130
  roles: []
131
131
  type: agent
132
132
  provider: codex
133
- model: gpt-5.6-sol
133
+ model: gpt-6.1-sol
134
134
  effort: high
135
135
  mode: edit
136
136
  stage_role: executor
@@ -262,6 +262,36 @@ rate_limit_policy:
262
262
 
263
263
  この例では共有 defaults の検証は両 project に適用され、`specdojo-lp` の 2 件は `prj-0002` の run だけに適用されます。`prj-0001` は `specdojo-lp` を `repos` に持たなくても影響を受けません。共有側と project 側に同じ ID・同じ `repo` の組を書くと、合成後の重複として agent 起動前にエラーになります。project 固有の検証も親 runner が固定 argv で実行し、evidence には `source: runner` と実行先の `repo` が記録されます。
264
264
 
265
+ 共有 defaults の検証を減らす場合は、`projects.<id>.run.parent_validations_exclude` に除外する検証を指定します。たとえば共有一覧が `lint-fm`・`lint-md`・`lint-ts`・`typecheck`・`test-unit`・`test-integration`・`validate-schema` の場合、文書と LP を扱う `prj-0002` だけで本体の検証を外す設定は次のとおりです。`exec-defaults.yaml` の複製は不要です。
266
+
267
+ ```json
268
+ {
269
+ "projects": {
270
+ "prj-0001": {
271
+ "run": { "exec_defaults": ".specdojo/exec-defaults.yaml" }
272
+ },
273
+ "prj-0002": {
274
+ "repos": [{ "name": "specdojo-lp", "path": "../specdojo-lp" }],
275
+ "run": {
276
+ "exec_defaults": ".specdojo/exec-defaults.yaml",
277
+ "parent_validations_exclude": [
278
+ "lint-ts",
279
+ "typecheck",
280
+ "test-unit",
281
+ "test-integration",
282
+ "validate-schema"
283
+ ],
284
+ "parent_validations": [{ "id": "typecheck", "repo": "specdojo-lp" }]
285
+ }
286
+ }
287
+ }
288
+ }
289
+ ```
290
+
291
+ 有効な一覧は「共有 defaults から除外 → project の追加」の順で求めます。この例の `prj-0002` では `lint-fm`・`lint-md`・`specdojo-lp` の `typecheck` だけが実行され、`prj-0001` の 7 件は変わりません。除外を省略するか `[]` にすると従来の追記動作を保ちます。検証以外の共有 defaults の設定も保持します。
292
+
293
+ 除外の要素も ID または `{ id, repo }` です。ID だけなら `repo: project` と同じで、同じ ID のプロダクトリポジトリ向け検証は除外しません。除外先は共有一覧に存在する ID と実行先の組に限り、project の追加一覧からは除外しません。未知の ID、不正な要素、共有一覧に存在しない組の除外、除外一覧内または最終一覧内の組の重複は、agent 起動前に設定エラーになります。除外前の共有一覧自体も検証するため、除外で不正な共有設定を隠すことはできません。除外した組を追加一覧で末尾に戻すことはできます。
294
+
265
295
  `wait` の待機中は、同一 worktree と register / pipeline の状態を別 run から保護するため project の実行ロックを保持します。register worktree の `--join` 実行は共有枠の範囲で引き続き動作できます。wait / fallback の再開時刻と切替元・切替先は pipeline state と executor evidence に記録されます。
266
296
 
267
297
  ### 5.1. register の難易度別振り分け
@@ -507,13 +537,13 @@ specdojo exec run --project <project-id> --task <task-id> \
507
537
 
508
538
  executor の出力は、そのまま reporter へ渡さずに run 単位の evidence へ整形して保存します。保存先は `<execution_path>/exec/evidence/<task-id>/<run-id>/` です。
509
539
 
510
- | ファイル | 内容 |
511
- | --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
512
- | `evidence.json` | stage の実行結果、変更ファイル一覧、diff サマリ、検証結果、最終メッセージ、失敗理由、ログ参照 |
513
- | `executor.log` | executor の標準出力・標準エラーの抜粋(人が調査するための参照先) |
514
- | `reporter-attempt-<n>.stdout.log` / `reporter-attempt-<n>.stderr.log` | 失敗した reporter の形式試行ごとの stdout / stderr(秘匿処理後の生出力) |
515
- | `parent-validation-attempt-<n>-<id>.log` | 失敗した親検証の stdout / stderr(秘匿処理後の出力) |
516
- | `pipeline-state.json` | executor / reporter の状態・actor・試行回数・成果物参照 |
540
+ | ファイル | 内容 |
541
+ | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
542
+ | `evidence.json` | stage の実行結果、変更ファイル一覧、diff サマリ、検証結果、最終メッセージ、申し送り、失敗理由、ログ参照 |
543
+ | `executor.log` | executor の標準出力・標準エラーの抜粋(人が調査するための参照先) |
544
+ | `reporter-attempt-<n>.stdout.log` / `reporter-attempt-<n>.stderr.log` | 失敗した reporter の形式試行ごとの stdout / stderr(秘匿処理後の生出力) |
545
+ | `parent-validation-attempt-<n>-<id>.log` | 失敗した親検証の stdout / stderr(秘匿処理後の出力) |
546
+ | `pipeline-state.json` | executor / reporter の状態・actor・試行回数・成果物参照 |
517
547
 
518
548
  引き渡しの方針は次のとおりです。
519
549
 
@@ -524,10 +554,12 @@ executor の出力は、そのまま reporter へ渡さずに run 単位の evid
524
554
  - reporter が非ゼロ終了または形式エラーで失敗した場合、同じ reporter stage 内の各形式試行を `reporter-attempt-<n>.stdout.log` と `reporter-attempt-<n>.stderr.log` に保存します。同じ run を resume して再度失敗した場合は、直近の失敗内容でこれらのファイルと `log_refs` を置き換えます。
525
555
  - 親検証は失敗時だけ出力を保存し、成功時は要約だけを記録します。失敗ログは `parent-validation-output` として `log_refs` から参照します。同じ run の resume や統合段の再検証では attempt 番号を増やして新しいログを追加し、以前の失敗ログを上書きしません。親検証の要約は 1,000 文字以内で先頭と末尾を残すため、末尾に出る失敗ケース名と件数を evidence から確認できます。
526
556
  - evidence ディレクトリは Git の管理対象です。成功して統合された run のログは履歴に残り、失敗中の worktree では未コミットのまま保持されます。`--force-restart` などで worktree を破棄すると未コミットログも失われるため、必要な調査を先に行います。既知パターンは保存前に秘匿しますが、未知形式の秘密が残る可能性を考慮し、ログを外部共有する前に内容を確認します。
527
- - executor が構造化した最終報告を返す場合は、標準出力に `<specdojo_executor_evidence>` タグで JSON(`final_message`・`validations`)を出します。`validations[].status` は `passed` / `failed` / `not_run` / `not_applicable` / `requires_human` のいずれかです。`not_applicable` はリポジトリが検査の適用条件を満たさない場合に使い、`reason` へ理由を必ず記録します。`requires_human` は、実 agent CLI の起動、利用枠や課金を伴う操作、認証情報やホスト側の操作など、agent の sandbox から実行できない確認だけに使います。実行できるが省略した検証には使わず、`not_run` として記録します。タグが無い場合は標準出力の残りを最終メッセージとして扱います。
557
+ - executor が構造化した最終報告を返す場合は、標準出力に `<specdojo_executor_evidence>` タグで JSON(`final_message`・`validations`・省略可能な `completion_status`・`handoff`)を出します。`validations[].status` は `passed` / `failed` / `not_run` / `not_applicable` / `requires_human` のいずれかです。`not_applicable` はリポジトリが検査の適用条件を満たさない場合に使い、`reason` へ理由を必ず記録します。`requires_human` は、実 agent CLI の起動、利用枠や課金を伴う操作、認証情報やホスト側の操作など、agent の sandbox から実行できない確認だけに使います。実行できるが省略した検証には使わず、`not_run` として記録します。タグが無い場合は標準出力の残りを最終メッセージとして扱います。
528
558
  - `pipeline.parent_validations` には `validate-schema`(`npm run validate:schema`)、`typecheck`(`npm run typecheck`)、`test-unit`(`npm run test:unit`)、`test-integration`(`npm run test:integration`)、`lint-ts`(`npm run lint:ts`)、`lint-fm`(`npm run lint:fm`)、`lint-md`(`npm run lint:md`)、`build`(`npm run build`)、`format-check`(`npm run format:check`)を指定できます。親 runner は executor の成功後・reporter の起動前に、指定順で固定 argv の検証を実行します。
529
559
  - executor prompt には設定済み ID と対応コマンドを明示します。executor はそのコマンドや対象限定版を sandbox 内で実行せず、executor evidence の validations にも含めなくてよいものとします。親 runner の結果は `source: runner` と許可リスト `id` 付きで同じ `validations` 配列へ保存します。executor が同じ検査を `not_run` または `not_applicable` として含めた場合も、同じリポジトリで実行された親 runner の結果を正とします。これにより sandbox 内で成立しない検証を親へ移した場合も二重実行せず、executor の重複報告で run を止めません。
530
560
  - result の `changed_files` のパスは evidence の `changes` から、execution の evidence、project register とその派生ビュー、当該 result という runner 管理記録を除いて runner が機械生成します。除外後の変更一覧だけを reporter へ渡し、edit の変更説明は evidence のパスと対にして受け取ります。runner はパスで突き合わせるため、説明の順序は問いません。説明が不足したパスには Git の変更メタデータ(追加・変更・削除・名前の変更、行数)を記録し、変更ファイルが多い場合(50 件超)はディレクトリごとに集約して記録します。evidence にないパスの説明は捨てます。`outcome` と `block_reason` は stage の状態・終了コード・保護機構が保存した理由・executor / 親 runner の検証から機械生成します。reporter の JSON Schema は文章項目と対応づけ用のパスだけを受け付け、いずれかの検証が failed または `not_run` なら、reporter の文章にかかわらず機械判定は blocked です。ただし、executor が `not_run` または `not_applicable` と記録したコマンドを、親 runner が同じリポジトリで同じコマンドとして実行し成功していれば、親 runner の結果を正として executor の報告を無視します。さらに、`npm run <name>` に対応する script がない、`npx <package>` の package が `dependencies` / `devDependencies` にない、検査の対象となる種類の変更ファイルがない、または SpecDojo サブコマンドの設定上の適用条件を満たさないことを runner が機械的に確定できる場合、その `not_run` は block せず、edit result の申し送りへ「適用外の検証(runner の判定)」として追記します。変更ファイル種別で判定する対応は共通規約の検査表を正本とし、`validate:schema:file` は `*.yaml` / `*.yml`、Prettier は `*.md` / `*.ts` / `*.js` / `*.json` / `*.yaml` / `*.yml`、markdownlint は `*.md` の変更がある場合だけ適用対象とします。rename は変更前後の両方を見て、プロダクトリポジトリのコマンドはそのリポジトリの変更だけで判定します。`typecheck` など、この対応に含まれない検査の判定は変更しません。SpecDojo の起動形は `specdojo <subcommand>`、`npx specdojo <subcommand>`、ソース/配布済み CLI の直接起動を認識し、`catalog validate` は対象 project の `catalog_path` で判定します。対象 project は、コマンドの `--project <id>`、run の対象 project(runner が execution path に一致する project を設定から特定したもの)、`current_project` の順に決めます。別の project が `catalog_path` を持っていても、run の対象 project に `catalog_path` がなければ適用外です。対象 project に `catalog_path` があっても、executor の変更(runner 管理記録を除き、rename は変更前後の両方を見ます)が `docs/ja/projects/` 配下に及ばない run では、plan の共通規約の検証表と同じく適用外とし、executor の `not_applicable` も受理します。変更が及ぶ run では従来どおり適用対象です。また、`<repo>:<path>` を引数に含むコマンド、`--prefix <repo>` 付きのコマンド、または `$SPECDOJO_REPO_<NAME>` / `${SPECDOJO_REPO_<NAME>}` を含むコマンドは、対象 project が `repos` で宣言したそのプロダクトリポジトリの `package.json` で script と依存を判定します(`--prefix` はリポジトリ名か設定の `path` と一致するものを対象にします)。設定が読めない、対象 project を特定できない、または適用条件を未定義のサブコマンドは機械的な救済をせず、通常の `not_run` として扱います。executor の failed は親 runner の成功や適用外判定で打ち消しません。`npm run check` のように npm script を `&&` でつないだだけの合成コマンドを executor が `not_run` とした場合は、対象リポジトリの `package.json` の script を展開し、構成する各コマンドが同じリポジトリの親検証か executor 自身の検証で通っていれば満たされたものとして扱います。`npm test` は、`npm run test:unit` と `npm run test:integration` の両方が通っていれば満たされたものとします。構成するコマンドの script の中身と同じコマンドを executor が直接実行して通した場合も満たします(`tsx` の起動の書き方の違いはそろえて比べます)。任意のシェルを含む script は展開しません。理由付きの `not_applicable` は block の理由にせず、runner が edit result の申し送りへ「適用外の検証: `<コマンド>`(<理由>)」として機械的に追記します。ただし、理由がない場合、変更ファイル種別を含む適用条件を満たした `npm run <name>` の script が存在する場合、または同条件を満たした `npx <package>` の package が `dependencies` / `devDependencies` に存在する場合は誤申告として blocked にします。SpecDojo サブコマンドは package の有無だけでは反証せず、既知の適用条件を設定から判定します。適用条件が未定義なら理由付きの agent の申告に従います。`specdojo index build`(`npx specdojo index build`・`node --import tsx src/specdojo.ts index build` などの起動形を含みます)は runner が担う検証です。出力先の `.specdojo/doc-index.json` は agent が書き込めず、index は worktree の準備と統合の前に runner が再生成するため、executor への指示では実行も記録もしないよう伝えます。executor が `not_run` / `not_applicable` と記録しても block の理由にせず、`not_run` の場合は edit result の申し送りへ「runner が担う検証: `<コマンド>`(<理由>)」として追記します。runner の再生成が失敗した場合は worktree の準備で run が止まるか、runner の検証の失敗として block するため、満たしたものとは扱いません。executor の failed は救済せず、ほかの SpecDojo サブコマンドの `not_run` の扱いも変えません。executor の `requires_human` は block の理由にせず、runner が edit result の申し送りへ「人の確認が必要: `<コマンド>`(<要約>)」として機械的に追記します。項目は review へ進み、人が確認してから close します。
561
+ - `completion_status` は作業の完了状態を示す省略可能な欄で、値は `complete` / `incomplete` です。欄のない既存の報告は `complete` として扱います。値が指定されていてこの 2 値に合わない場合は、安全側に倒して `incomplete` として保存します。executor は計画の作業を終えられなかった場合、`incomplete` とし、理由を `final_message`、残作業を `handoff` に書きます。終了コード 0 や親検証の成功では未完了の申告を上書きしません。`exec run --register` は親検証・reporter を起動する前に停止し、項目を `waiting` にして、秘匿処理・文字数制限を適用した `final_message` の要旨を `block_reason` に記録します。worktree 実行では変更と evidence を残し、統合しません。pipeline の executor は `blocked`、evidence の `stage.status` と `exit_code` は実際のプロセス結果のままとします。`--resume --resume-from executor`(または `--resume`)で再開でき、前回の理由と `handoff`、途中の変更を executor に引き継ぎます。完了を申告し直し、必要な検証を通過してから review・統合へ進みます。
562
+ - `handoff` は executor が申し送る判断の理由、保護された設定の変更案、次のアクションなどの文字列配列です。先頭 100 件、各 4,000 文字までを秘匿処理して evidence に保存し、空文字列や文字列以外の要素は除外します。省略した既存の報告・evidence も有効です。reporter にはこの欄も渡し、edit result の「申し送り」には runner が reporter の補足と合わせて機械的に転記します。同一の文字列は重複させず、reporter が省略しても executor の記録は残します。register の完了条件が result への記録を求める場合、pipeline の executor は個票の対応結果と報告の `handoff` の両方に書きます。close の前には個票の対応結果と result の両方を確認します。
531
563
  - reporter の出力は JSON Schema で厳格に検証します。形式不正のときは同じ plan と evidence のまま reporter だけを最大 3 回再実行し、executor は再実行しません。
532
564
  - reporter stage の再開では、現在の設定 ID と一致する親検証が保存済み evidence にそろっている場合だけ executor evidence を再利用します。`{ id, repo }` を使う場合は、ID とリポジトリの組が一致することを求めます。再実行時も同じ割り当てで、各リポジトリの worktree を `cwd` にします。保存済みの親検証がすべて成功していれば再実行しません。`failed` / `not_run` があれば、親 runner が現在の worktree で固定許可リストの親検証を再実行し、同じ ID の結果を evidence 上で置換してから reporter へ渡します。過去の親検証ログは置換せず、新しい失敗ログだけを追加します。executor 由来の検証は再実行・置換しません。設定 ID が変わった、または結果が欠けている場合、Schedule 実行は新しい executor run としてやり直し、register 実行は明示的な再実行を促して再開を拒否します。
533
565
  - result の frontmatter は runner が scaffold した内容を保ち、本文は検証済みの reporter 文章と evidence 由来の事実を組み合わせて runner が描画します。reporter はファイルを書きません。
@@ -536,17 +568,17 @@ executor の出力は、そのまま reporter へ渡さずに run 単位の evid
536
568
 
537
569
  agent が exec 実行時に読み込む provider 固有の設定(agent 定義・permission 設定)は、npm package 内の `templates/<provider>/` を配布原本とし、利用プロジェクトへコピーして使います。worktree 実行はコミット済み内容から worktree を作るため、コピーした設定は必ずコミットします。
538
570
 
539
- 配置規則は provider 名から機械的に決まります(`agents/` 配下 → `.<provider>/agents/`、`rules/` 配下 → `.<provider>/rules/`、それ以外のファイル → `.specdojo/<provider>/`、`README.md` はコピーしません)。provider ごとの配布内容は次のとおりです。
571
+ 配置規則は provider 名から機械的に決まります(`agents/` 配下 → `.<provider>/agents/`、`rules/` 配下 → `.<provider>/rules/`、`opencode.json` → リポジトリ直下の `opencode.json`、それ以外のファイル → `.specdojo/<provider>/`、`README.md` はコピーしません)。provider ごとの配布内容は次のとおりです。
540
572
 
541
573
  | provider | 配布内容 | 配置先 |
542
574
  | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
543
575
  | claude | `agents/*.md`(役割ごとの agent 定義)、`settings.edit.json` / `settings.orchestrator.json` / `settings.review.json` / `settings.report.json` | `.claude/agents/`、`.specdojo/claude/` |
544
576
  | codex | `agents/*.toml`(親 Codex が spawn する subagent 定義)、`rules/*.rules`(command rule) | `.codex/agents/`、`.codex/rules/` |
545
- | opencode | `agents/*.md`(permission frontmatter 込みの agent 定義) | `.opencode/agents/` |
577
+ | opencode | `agents/*.md`(permission frontmatter 込みの agent 定義)、`opencode.json`(Ollama 接続・モデル設定) | `.opencode/agents/`、`opencode.json` |
546
578
  | copilot | `agent-members-snippet.yaml`(agent 定義)と `exec-defaults-snippet.yaml`(`providers.copilot` の command template・rate limit 検出)の参照スニペット | `.specdojo/copilot/` |
547
579
  | antigravity | `orchestrator.md`、agent / provider 設定スニペット。`settings.global.json` は `--global` 用のマージ原本であり repository へは配置しない | `.specdojo/antigravity/` |
548
580
 
549
- 導入手順とテンプレートに含めない手動設定(`opencode.json`、`.codex/config.toml` など)は各 `templates/<provider>/README.md` を参照します。
581
+ 導入手順と手動設定(`.codex/config.toml` や接続先 URL の調整、Modelfile によるローカル派生タグの作成など)は各 `templates/<provider>/README.md` を参照します。
550
582
 
551
583
  `.specdojo/exec-defaults.yaml` の `providers.claude.command_template` には `--settings .specdojo/claude/settings.{mode}.json` を指定します。`--permission-mode bypassPermissions` は使いません(`.claude/settings.json` の `disableBypassPermissionsMode: "disable"` で起動自体を拒否します)。
552
584
 
@@ -583,16 +615,44 @@ specdojo config scaffold --provider claude
583
615
 
584
616
  `specdojo init --exec` と `config scaffold` が配布する agent の名簿と定義は、実体と別名の 2 段構成です(0.4.0 から)。実体は model の系統と役割で名付け、provider・`model`・役割を持ちます。従来の名前は `aliases` で実体を指す別名として残します。claude と opencode の agent の定義は役割(executor・review executor・reporter)ごとの 1 ファイルで `model` を持たず、`command_params.by_mode` で mode から定義を選び、model は実体の `model` を `--model {model}` で渡します。
585
617
 
586
- | provider | init が生成する実体 | 別名(従来の名前) | model の書き場所 |
587
- | ----------- | ----------------------------------------------------------------- | -------------------------------------------------------------------- | ---------------------------------------------------- |
588
- | claude | `sonnet-executor`・`sonnet-review-executor`・`sonnet-reporter` | `claude-executor`・`claude-review-executor`・`claude-reporter` | 実体の `model`(`sonnet`) |
589
- | codex | `terra-executor`・`terra-review-executor`・`terra-reporter` | `codex-executor`・`codex-review-executor`・`codex-reporter` | 実体の `model`(effort は `by_proficiency`) |
590
- | opencode | `gemma-executor`・`gemma-review-executor`・`gemma-reporter` | `opencode-executor`・`opencode-review-executor`・`opencode-reporter` | 実体の `model`(`opencode.json` の provider 名込み) |
591
- | antigravity | `flash-executor`・`flash-review-executor`・`flash-reporter` | `agy-executor`・`agy-review-executor`・`agy-reporter` | 実体の `model`(推論強度を含む ID) |
592
- | copilot | `copilot-executor`・`copilot-review-executor`・`copilot-reporter` | なし(`--model auto` で model を自動選択するため系統で名付けない) | `command_template` の `--model auto` |
618
+ | provider | init が生成する実体 | 別名(従来の名前) | model の書き場所 |
619
+ | ----------- | --------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | --------------------------------------------------------------------------- |
620
+ | claude | `sonnet-executor`・`sonnet-review-executor`・`sonnet-reporter` | `claude-executor`・`claude-review-executor`・`claude-reporter` | 実体の `model`(`sonnet`) |
621
+ | claude | `opus-executor`・`opus-review-executor`(expert) | `claude-expert-executor`・`claude-expert-review-executor` | 実体の `model`(`opus`) |
622
+ | codex | `luna-executor`・`luna-review-executor`・`luna-reporter` | `codex-executor`・`codex-review-executor`・`codex-reporter` | 実体の `model`(`gpt-6-luna`、effort は `by_proficiency`) |
623
+ | codex | `sol-executor`・`sol-review-executor`(expert) | `codex-expert-executor`・`codex-expert-review-executor` | 実体の `model`(`gpt-6.1-sol`、effort は `by_proficiency`) |
624
+ | opencode | `gemma-executor`・`gemma-review-executor`・`gemma-reporter`、`qwen-executor`・`qwen-review-executor`・`qwen-reporter` | `opencode-executor`・`opencode-review-executor`・`opencode-reporter` | 実体の `model`(`opencode.json` の provider 名込み、原則 `*-mlx-work-64k`) |
625
+ | antigravity | `flash-executor`・`flash-review-executor`・`flash-reporter` | `agy-executor`・`agy-review-executor`・`agy-reporter` | 実体の `model`(推論強度を含む ID) |
626
+ | copilot | `copilot-executor`・`copilot-review-executor`・`copilot-reporter` | なし(`--model auto` で model を自動選択するため系統で名付けない) | `command_template` の `--model auto` |
627
+
628
+ claude と codex は normal と expert の 2 段を持ちます(0.4.6 から)。expert の実体には `proficiency: expert` を付けます。init が書く振り分けの表(`routing`)は、hard を expert の別名(`claude-expert-executor`・`codex-expert-executor`)、medium と easy を normal の別名にし、reporter はどの難易度でも normal の別名にします。expert の段がない provider(opencode・antigravity など)は、hard も normal の別名を使います。codex の reasoning effort は `by_proficiency` で normal が `medium`、expert が `high` で、`gpt-6-luna` は Max までしか受け付けないため Ultra を割り当てません。
593
629
 
594
630
  init は選んだ provider の実体だけを名簿へ書き、別名は向き先の実体が選ばれたものだけを残します。次の手順の案内(`--executor-by` / `--reporter-by`)には別名を示します。antigravity の `agent-members-snippet.yaml` は実体を `disabled: true` で配布するため、別名は末尾にコメントの例として置きます。別名は無効な member を指せないので、向き先の実体を有効にしたものだけを `aliases` へ写します。
595
631
 
632
+ `gpt-6-astra` は雛形の既定に入れません。使う場合は、次のように実体を名簿へ足し、`--executor-by astra-executor` や `routing` で指名します。
633
+
634
+ ```yaml
635
+ members:
636
+ - nickname: astra-executor
637
+ display_name: Codex Astra Executor
638
+ email: null
639
+ roles: []
640
+ type: agent
641
+ provider: codex
642
+ model: gpt-6-astra
643
+ mode: edit
644
+ stage_role: executor
645
+ capabilities: [web_search]
646
+ proficiency: expert
647
+ priority: 1
648
+ persona: task-executor
649
+ scheduler_strategy: critical-first
650
+ ```
651
+
652
+ 0.4.5 までの init が作った名簿(`terra-executor` などの `gpt-5.6-terra` の実体と `orch:terra`)は、init も scaffold も書き換えません。新しい名前へそろえる場合は、`.specdojo/agent-members.yaml` の `terra-*` を `luna-*`(`model: gpt-6-luna`)へ名前を変え、`sol-*` を加えるか `model` を `gpt-6.1-sol` にし、`aliases` の `codex-*` の向き先を合わせます。`package.json` は `config scaffold --provider codex` を実行すると `orch:luna` が加わります。不要になった `orch:terra` は手で消し、既存の `orch:sol` は上書きされないため `-m gpt-6.1-sol` へ手で直します。
653
+
654
+ 配布する `templates/codex/agents/*.toml` も名簿と同じく GPT-6 の 2 段構成(normal の `codex-executor`・`codex-review-executor` は `gpt-6-luna`、expert の `codex-expert-executor`・`codex-expert-review-executor` と `specdojo-orchestrator` は `gpt-6.1-sol`)にそろえています。既存の利用者の `.codex/agents/*.toml` は scaffold でも上書きされないため、`specdojo config scaffold --provider codex --force` で配布原本を再配置するか、各 `.codex/agents/*.toml` の `model`(`gpt-5.4-mini`・`gpt-5.5`・`gpt-5.6-terra`)を手動で `gpt-6-luna` / `gpt-6.1-sol` へ書き換えます。
655
+
596
656
  既存の利用者の 1 段の名簿(`aliases` も `model` も持たない member と、`--agent {nickname}` の `command_template`)は、変更しなくてもそのまま動きます。
597
657
 
598
658
  - `aliases` は省略でき、`model` を持たない member は従来どおり `command_params`(`by_proficiency` など)の `model` で起動します。member の `model` がある場合だけ、そちらが優先されます。
@@ -749,6 +809,8 @@ runner は agent の各試行前後でファイル内容を比較し、差分が
749
809
 
750
810
  agentと親検証の子プロセスを起動する際は、`gitEnvironment()`で`GIT_DIR`、`GIT_WORK_TREE`、`GIT_COMMON_DIR`、index・object・replace関連のrepository固有環境変数を除去します。除去対象は`src/shared/git-environment.ts`の`GIT_LOCAL_ENV_VARS`を正本とします。Vitestの全3設定も共通setupを使ってtest module読込前に同じ変数をworkerから除去するため、Git hook経由で`npm test`が起動されても、テストfixtureはcwdの一時repositoryを参照し、linked worktreeのgitdirや共有configを参照しません。
751
811
 
812
+ Vitestの共通setupは、シェルから継承した`SPECDOJO_PROJECT`も除去します。これにより、orchestratorの対象projectがテストfixtureの設定に存在しなくても、unit・integrationのworkerとその子プロセスはfixture側の設定からprojectを解決できます。project選択を検証するテスト自身がsetupの後に設定する`SPECDOJO_PROJECT`は有効です。
813
+
752
814
  TypeScriptのテスト・tool・本体コードが`spawnSync`、`spawn`、`execFileSync`、`execFile`でGitを直接起動する箇所は、AST検査により`gitEnvironment()`から作った`env`だけを許可します。`env: process.env`や単なる`env`プロパティは隔離済みとは扱いません。shell scriptとnpm scriptのGit起動はこのAST検査の対象外ですが、現状のhook経路はVitest setupを必ず通り、hookから直接Gitを起動するテスト用scriptはありません。今後その経路を追加する場合は、入口で`GIT_LOCAL_ENV_VARS`相当を除去する専用検査を追加します。
753
815
 
754
816
  executor / reporter pipelineのexecutor promptは、commitとrepository設定を親runnerが所有することを明記し、`git commit`およびlocal / global / system configの変更(`user.name` / `user.email`を含む)を禁止します。fixture commitに使うテスト用identityはVitest workerと子プロセスの環境変数だけへ注入し、fixtureを含むrepositoryのlocal configへは書き込みません。