specdojo 0.4.2 → 0.4.4
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.
- package/.github/agents/specdojo-orchestrator.md +2 -0
- package/CHANGELOG.md +29 -0
- package/dist/catalog/build.js +15 -13
- package/dist/catalog/generate.js +27 -12
- package/dist/commands/init.js +10 -7
- package/dist/commands/orchestrator.js +9 -2
- package/dist/devcontainer/command.js +1 -1
- package/dist/devcontainer/scaffold.js +24 -9
- package/dist/docs/doc-index.js +11 -0
- package/dist/exec/core.js +4 -0
- package/dist/exec/plans-core.js +10 -1
- package/dist/exec/plans-generation.js +13 -0
- package/dist/exec/plans-storage.js +4 -0
- package/dist/exec/register.js +64 -6
- package/dist/exec/results.js +5 -1
- package/dist/exec/strategy.js +4 -0
- package/dist/kata/authoring.js +146 -0
- package/dist/kata/command.js +64 -2
- package/dist/kata/kata.js +69 -12
- package/dist/register/approach.js +29 -1
- package/dist/register/core.js +3 -3
- package/dist/register/create-commands.js +9 -0
- package/dist/register/cross-project.js +9 -2
- package/dist/register/external-project.js +136 -0
- package/dist/register/item.js +31 -5
- package/dist/schedule/strategy-profiles.js +3 -0
- package/dist/shared/agent-types.js +4 -0
- package/dist/shared/provider-scaffold.js +3 -3
- package/dist/shared/specdojo-config.js +109 -2
- package/dist/shared/text.js +3 -1
- package/docs/ja/specdojo/exec-templates/xep-recipe-authoring-template.md +45 -0
- package/docs/ja/specdojo/exec-templates/xep-rulebook-authoring-template.md +45 -0
- package/docs/ja/specdojo/exec-templates/xep-sample-authoring-template.md +45 -0
- package/docs/ja/specdojo/exec-templates/xep-template-authoring-template.md +45 -0
- package/docs/ja/specdojo/guides/docs-editing-guide.md +32 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +1 -1
- package/docs/ja/specdojo/guides/exec-config-guide.md +13 -6
- package/docs/ja/specdojo/guides/kata-guide.md +6 -0
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +4 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +352 -68
- package/docs/ja/specdojo/guides/register-operation-guide.md +18 -0
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +10 -2
- package/docs/ja/specdojo/guides/ryu-guide.md +18 -4
- package/docs/ja/specdojo/guides/use-case-guide.md +2 -2
- package/docs/ja/specdojo/references/command-reference.md +39 -20
- package/docs/ja/specdojo/references/specdojo-config-reference.md +33 -7
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +2 -1
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +4 -0
- package/docs/ja/specdojo/standards/recipe-authoring-standard.md +10 -10
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +13 -13
- package/docs/ja/specdojo/standards/sample-authoring-standard.md +4 -4
- package/docs/ja/specdojo/standards/template-authoring-standard.md +4 -4
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +6 -0
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +6 -6
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +21 -4
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +29 -0
- package/package.json +10 -10
- package/templates/antigravity/README.md +1 -1
- package/templates/antigravity/orchestrator.md +2 -0
- package/templates/antigravity/settings.global.json +5 -0
- package/templates/claude/README.md +11 -8
- package/templates/claude/agents/specdojo-orchestrator.md +2 -0
- package/templates/claude/settings.edit.json +10 -1
- package/templates/claude/settings.orchestrator.json +90 -0
- package/templates/claude/settings.report.json +14 -1
- package/templates/claude/settings.review.json +13 -1
- package/templates/codex/README.md +7 -5
- package/templates/codex/agents/specdojo-orchestrator.toml +2 -0
- package/templates/codex/orchestrator.md +2 -0
- package/templates/codex/rules/specdojo.rules +48 -0
- package/templates/devcontainer/devcontainer.json +1 -4
- package/templates/opencode/README.md +2 -1
- package/templates/opencode/agents/opencode-executor.md +2 -0
- package/templates/opencode/agents/opencode-review-executor.md +2 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +61 -5
package/dist/register/item.js
CHANGED
|
@@ -98,6 +98,29 @@ export function ticketRefCell(filename) {
|
|
|
98
98
|
}
|
|
99
99
|
// Markdown のコードスパン。コードとして明示された内容は、表セルでも著者の記法を保持する。
|
|
100
100
|
const MARKDOWN_CODE_SPAN = /(`+)[\s\S]*?\1/g;
|
|
101
|
+
// URL の囲みを適用しない Markdown の範囲。コードスパン、山括弧、リンク(shortcut / reference
|
|
102
|
+
// link を含む)は著者がすでに選んだ記法として保持する。
|
|
103
|
+
const MARKDOWN_URL_PROTECTED_SPAN = /(`+)[\s\S]*?\1|<[^<>\r\n]*>|!?\[[^\]\r\n]*\](?:\([^\r\n)]*\)|\[[^\]\r\n]*\])?/g;
|
|
104
|
+
// 全角の閉じ括弧・句読点と半角の閉じ括弧は URL の直後に続く本文として扱う。
|
|
105
|
+
// ASCII の句読点は query に使えるため一度 URL 候補へ含め、末尾にあるものだけ戻す。
|
|
106
|
+
const BARE_HTTP_URL = /https?:\/\/[^\s<>"'`)]}〉》」』】〕〗〙〛。、,!?;:…)\]}]+/g;
|
|
107
|
+
const TRAILING_ASCII_URL_PUNCTUATION = /[.,;:!?]+$/;
|
|
108
|
+
function encloseBareHttpUrls(text) {
|
|
109
|
+
const encloseSegment = (segment) => segment.replace(BARE_HTTP_URL, (candidate) => {
|
|
110
|
+
const trailing = candidate.match(TRAILING_ASCII_URL_PUNCTUATION)?.[0] ?? "";
|
|
111
|
+
const url = trailing ? candidate.slice(0, -trailing.length) : candidate;
|
|
112
|
+
return url ? `<${url}>${trailing}` : candidate;
|
|
113
|
+
});
|
|
114
|
+
let result = "";
|
|
115
|
+
let lastIndex = 0;
|
|
116
|
+
for (const match of text.matchAll(MARKDOWN_URL_PROTECTED_SPAN)) {
|
|
117
|
+
const start = match.index ?? 0;
|
|
118
|
+
result += encloseSegment(text.slice(lastIndex, start));
|
|
119
|
+
result += match[0];
|
|
120
|
+
lastIndex = start + match[0].length;
|
|
121
|
+
}
|
|
122
|
+
return result + encloseSegment(text.slice(lastIndex));
|
|
123
|
+
}
|
|
101
124
|
// コードスパン外の未エスケープな強調記号をエスケープする。
|
|
102
125
|
// 記号の直前に偶数個のバックスラッシュがある場合は Markdown 上で未エスケープなので、
|
|
103
126
|
// バックスラッシュを 1 個加える。奇数個なら既にエスケープ済みとして保持する。
|
|
@@ -107,7 +130,10 @@ function escapeTableCellEmphasis(text) {
|
|
|
107
130
|
});
|
|
108
131
|
let result = "";
|
|
109
132
|
let lastIndex = 0;
|
|
110
|
-
|
|
133
|
+
// URL 内の `*` / `_` は URL の一部なので変えない。bare URL はこの処理より先に
|
|
134
|
+
// autolink 化されるが、Markdown link のリンク先にある URL も同じ規則で保持する。
|
|
135
|
+
const protectedSpan = new RegExp(`${MARKDOWN_CODE_SPAN.source}|${BARE_HTTP_URL.source}`, "g");
|
|
136
|
+
for (const match of text.matchAll(protectedSpan)) {
|
|
111
137
|
const start = match.index ?? 0;
|
|
112
138
|
result += escapeSegment(text.slice(lastIndex, start));
|
|
113
139
|
result += match[0];
|
|
@@ -115,9 +141,9 @@ function escapeTableCellEmphasis(text) {
|
|
|
115
141
|
}
|
|
116
142
|
return result + escapeSegment(text.slice(lastIndex));
|
|
117
143
|
}
|
|
118
|
-
// 表セルへ埋め込むために1
|
|
119
|
-
//
|
|
120
|
-
//
|
|
144
|
+
// 表セルへ埋め込むために1行化し、素の HTTP(S) URL を autolink にしてから、列区切りの
|
|
145
|
+
// `|` と強調記号の `*` / `_` をエスケープする。既存コードスパン、Markdown link、
|
|
146
|
+
// autolink、エスケープ済みの記号は保持し、複数回の呼び出しに対して冪等にする。
|
|
121
147
|
export function toCell(text) {
|
|
122
148
|
if (typeof text !== "string")
|
|
123
149
|
return "";
|
|
@@ -126,7 +152,7 @@ export function toCell(text) {
|
|
|
126
152
|
.replace(/\s+/g, " ")
|
|
127
153
|
.replace(/(?<!\\)((\\\\)*)\|/g, "$1\\|")
|
|
128
154
|
.trim();
|
|
129
|
-
return escapeTableCellEmphasis(normalized);
|
|
155
|
+
return escapeTableCellEmphasis(encloseBareHttpUrls(normalized));
|
|
130
156
|
}
|
|
131
157
|
// H1(`# PJR-XXXX タイトル`)からタイトルを導出する。表示 ID の接頭辞は取り除く。
|
|
132
158
|
export function titleFromBody(body, id) {
|
|
@@ -249,6 +249,9 @@ export const STRATEGY_PROFILES = {
|
|
|
249
249
|
},
|
|
250
250
|
};
|
|
251
251
|
export function profileFor(approach) {
|
|
252
|
+
if (!(approach in STRATEGY_PROFILES)) {
|
|
253
|
+
throw new Error(`Approach "${approach}" has no schedule strategy profile; kata authoring approaches are register-only`);
|
|
254
|
+
}
|
|
252
255
|
return STRATEGY_PROFILES[approach];
|
|
253
256
|
}
|
|
254
257
|
// Serializable phase entry for sch-strategy.schema.yaml.
|
|
@@ -8,8 +8,8 @@ function isRecord(value) {
|
|
|
8
8
|
export { specdojoPackageRootDir } from "./package-paths.js";
|
|
9
9
|
export const ORCHESTRATOR_NPM_SCRIPTS = {
|
|
10
10
|
claude: {
|
|
11
|
-
"orch:opus": "specdojo orchestrator launch --provider claude -- --agent specdojo-orchestrator --model opus",
|
|
12
|
-
"orch:sonnet": "specdojo orchestrator launch --provider claude -- --agent specdojo-orchestrator --model sonnet",
|
|
11
|
+
"orch:opus": "specdojo orchestrator launch --provider claude -- --agent specdojo-orchestrator --model opus --settings .specdojo/claude/settings.orchestrator.json",
|
|
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
15
|
"orch:sol": 'specdojo orchestrator launch --provider codex -- -m gpt-5.6-sol "$(cat .specdojo/codex/orchestrator.md)"',
|
|
@@ -75,7 +75,7 @@ export async function buildProviderScaffoldPlan(opts) {
|
|
|
75
75
|
relFile === PROVIDER_GLOBAL_SETTINGS[provider]?.templateRelPath) {
|
|
76
76
|
continue;
|
|
77
77
|
}
|
|
78
|
-
const destinationRelPath = relFile.startsWith("agents/")
|
|
78
|
+
const destinationRelPath = relFile.startsWith("agents/") || relFile.startsWith("rules/")
|
|
79
79
|
? `.${provider}/${relFile}`
|
|
80
80
|
: `.specdojo/${provider}/${relFile}`;
|
|
81
81
|
entries.push({
|
|
@@ -120,6 +120,48 @@ export function resolveRegisterActor(actor, roster) {
|
|
|
120
120
|
accepted.join(", "));
|
|
121
121
|
}
|
|
122
122
|
export const DEFAULT_AGENT_MEMBERS_PATH = ".specdojo/agent-members.yaml";
|
|
123
|
+
export const KATA_AUTHORITY_PATTERN = /^(?!prj-)(?!specdojo$)[a-z][a-z0-9-]*$/;
|
|
124
|
+
function repositoryIdentityRoot(rootDir) {
|
|
125
|
+
const root = resolve(rootDir);
|
|
126
|
+
const dotGit = join(root, ".git");
|
|
127
|
+
if (!existsSync(dotGit) || statSync(dotGit).isDirectory())
|
|
128
|
+
return root;
|
|
129
|
+
const gitdirLine = readTextFileOrNull(dotGit)
|
|
130
|
+
?.split(/\r?\n/)
|
|
131
|
+
.find((line) => line.startsWith("gitdir:"));
|
|
132
|
+
if (!gitdirLine)
|
|
133
|
+
return root;
|
|
134
|
+
const gitdir = resolve(root, gitdirLine.slice("gitdir:".length).trim()).replaceAll("\\", "/");
|
|
135
|
+
const marker = "/.git/worktrees/";
|
|
136
|
+
const markerIndex = gitdir.lastIndexOf(marker);
|
|
137
|
+
return markerIndex >= 0 ? gitdir.slice(0, markerIndex) : root;
|
|
138
|
+
}
|
|
139
|
+
export function defaultKataAuthority(rootDir = specdojoRootDir()) {
|
|
140
|
+
const directoryName = basename(repositoryIdentityRoot(rootDir));
|
|
141
|
+
const normalized = directoryName
|
|
142
|
+
.toLowerCase()
|
|
143
|
+
.replace(/[^a-z0-9]+/g, "-")
|
|
144
|
+
.replace(/^-+|-+$/g, "");
|
|
145
|
+
const withLetterPrefix = /^[a-z]/.test(normalized) ? normalized : `repo-${normalized}`;
|
|
146
|
+
const withoutReservedAuthority = withLetterPrefix === "specdojo" || withLetterPrefix.startsWith("prj-")
|
|
147
|
+
? `repo-${withLetterPrefix}`
|
|
148
|
+
: withLetterPrefix;
|
|
149
|
+
return KATA_AUTHORITY_PATTERN.test(withoutReservedAuthority)
|
|
150
|
+
? withoutReservedAuthority
|
|
151
|
+
: "repository";
|
|
152
|
+
}
|
|
153
|
+
export function getKataAuthority(config, rootDir = specdojoRootDir()) {
|
|
154
|
+
return config?.kata_authority?.trim() || defaultKataAuthority(rootDir);
|
|
155
|
+
}
|
|
156
|
+
export function isSpecdojoSourceRepository(rootDir = specdojoRootDir()) {
|
|
157
|
+
try {
|
|
158
|
+
const pkg = JSON.parse(readFileSync(join(rootDir, "package.json"), "utf8"));
|
|
159
|
+
return pkg.name === "specdojo" && existsSync(join(rootDir, "src", "specdojo.ts"));
|
|
160
|
+
}
|
|
161
|
+
catch {
|
|
162
|
+
return false;
|
|
163
|
+
}
|
|
164
|
+
}
|
|
123
165
|
function findUpward(startDir, name) {
|
|
124
166
|
let currentDir = resolve(startDir);
|
|
125
167
|
while (true) {
|
|
@@ -213,6 +255,64 @@ function isRecord(value) {
|
|
|
213
255
|
}
|
|
214
256
|
const REPO_KEYS = new Set(["name", "path", "integration_branch", "setup"]);
|
|
215
257
|
const REPO_SETUP_KEYS = new Set(["install", "build"]);
|
|
258
|
+
const EXTERNAL_PROJECT_KEYS = new Set(["path", "project_id"]);
|
|
259
|
+
/** Resolve a configured external-project repository from the SpecDojo root. */
|
|
260
|
+
export function resolveExternalProjectRoot(rootDir, project) {
|
|
261
|
+
return resolve(rootDir, project.path);
|
|
262
|
+
}
|
|
263
|
+
/** Return external projects in configuration order with absolute repository roots. */
|
|
264
|
+
export function resolveExternalProjects(rootDir, config) {
|
|
265
|
+
return Object.entries(config.external_projects ?? {}).map(([alias, project]) => ({
|
|
266
|
+
alias,
|
|
267
|
+
...project,
|
|
268
|
+
repoRoot: resolveExternalProjectRoot(rootDir, project),
|
|
269
|
+
}));
|
|
270
|
+
}
|
|
271
|
+
/** Validate top-level `external_projects` declarations. */
|
|
272
|
+
export function validateExternalProjects(externalProjects, projectIds, rootDir) {
|
|
273
|
+
if (externalProjects === undefined)
|
|
274
|
+
return [];
|
|
275
|
+
if (!isRecord(externalProjects))
|
|
276
|
+
return ["external_projects must be an object"];
|
|
277
|
+
const errors = [];
|
|
278
|
+
for (const [alias, value] of Object.entries(externalProjects)) {
|
|
279
|
+
const at = `external_projects.${alias}`;
|
|
280
|
+
if (!REPO_NAME_PATTERN.test(alias)) {
|
|
281
|
+
errors.push(`external project alias ${JSON.stringify(alias)} must match ${String(REPO_NAME_PATTERN)}`);
|
|
282
|
+
}
|
|
283
|
+
if (projectIds.includes(alias)) {
|
|
284
|
+
errors.push(`${at} collides with local project id "${alias}"`);
|
|
285
|
+
}
|
|
286
|
+
if (!isRecord(value)) {
|
|
287
|
+
errors.push(`${at} must be an object with path and project_id`);
|
|
288
|
+
continue;
|
|
289
|
+
}
|
|
290
|
+
for (const key of Object.keys(value).sort()) {
|
|
291
|
+
if (!EXTERNAL_PROJECT_KEYS.has(key))
|
|
292
|
+
errors.push(`${at}: unknown key "${key}"`);
|
|
293
|
+
}
|
|
294
|
+
const path = value.path;
|
|
295
|
+
if (typeof path !== "string" || path.trim().length === 0) {
|
|
296
|
+
errors.push(`${at}.path must be a non-empty string`);
|
|
297
|
+
}
|
|
298
|
+
else if (isAbsolute(path)) {
|
|
299
|
+
errors.push(`${at}.path must be relative to the SpecDojo root (got absolute "${path}")`);
|
|
300
|
+
}
|
|
301
|
+
else {
|
|
302
|
+
const absolutePath = resolve(rootDir, path);
|
|
303
|
+
if (!existsSync(absolutePath)) {
|
|
304
|
+
errors.push(`${at}.path "${path}" does not exist (resolved to ${absolutePath})`);
|
|
305
|
+
}
|
|
306
|
+
else if (!statSync(absolutePath).isDirectory()) {
|
|
307
|
+
errors.push(`${at}.path "${path}" is not a directory (resolved to ${absolutePath})`);
|
|
308
|
+
}
|
|
309
|
+
}
|
|
310
|
+
if (typeof value.project_id !== "string" || value.project_id.trim().length === 0) {
|
|
311
|
+
errors.push(`${at}.project_id must be a non-empty string`);
|
|
312
|
+
}
|
|
313
|
+
}
|
|
314
|
+
return errors;
|
|
315
|
+
}
|
|
216
316
|
/**
|
|
217
317
|
* Validate `projects.<projectId>.repos`. Returns one message per problem (empty when valid) so
|
|
218
318
|
* loadConfig can report every misconfigured repository at once. `path` is resolved from
|
|
@@ -562,6 +662,11 @@ export function loadConfig(configRootDir = specdojoRootDir()) {
|
|
|
562
662
|
}
|
|
563
663
|
assertProtectedAgentMembersPath(parsed.agent_members_path, configPath);
|
|
564
664
|
}
|
|
665
|
+
if (parsed.kata_authority !== undefined &&
|
|
666
|
+
(typeof parsed.kata_authority !== "string" ||
|
|
667
|
+
!KATA_AUTHORITY_PATTERN.test(parsed.kata_authority))) {
|
|
668
|
+
throw new Error(`Invalid .specdojo/specdojo.config.json: kata_authority must match ${KATA_AUTHORITY_PATTERN}`);
|
|
669
|
+
}
|
|
565
670
|
for (const [projectId, project] of Object.entries(parsed.projects)) {
|
|
566
671
|
if (!isValidProjectConfig(project)) {
|
|
567
672
|
throw new Error(`Invalid .specdojo/specdojo.config.json: projects.${projectId} must omit ` +
|
|
@@ -574,9 +679,11 @@ export function loadConfig(configRootDir = specdojoRootDir()) {
|
|
|
574
679
|
const repoErrors = projectIds
|
|
575
680
|
.sort()
|
|
576
681
|
.flatMap((projectId) => validateProjectRepos(projectId, parsed.projects[projectId], projectIds, rootDir));
|
|
577
|
-
|
|
682
|
+
const externalProjectErrors = validateExternalProjects(parsed.external_projects, projectIds, rootDir);
|
|
683
|
+
const configErrors = [...repoErrors, ...externalProjectErrors];
|
|
684
|
+
if (configErrors.length > 0) {
|
|
578
685
|
throw new Error(`Invalid .specdojo/specdojo.config.json (${configPath}):\n` +
|
|
579
|
-
|
|
686
|
+
configErrors.map((message) => ` - ${message}`).join("\n"));
|
|
580
687
|
}
|
|
581
688
|
return { configPath, config: parsed };
|
|
582
689
|
}
|
package/dist/shared/text.js
CHANGED
|
@@ -80,7 +80,9 @@ function replaceOutsideMarkdownCodeSpans(text, replace) {
|
|
|
80
80
|
// ドットを含めるのは `dct-<domain>.yaml` のような拡張子付きの参照を分断しないためだが、
|
|
81
81
|
// 文末の句点を巻き込まないよう、末尾のドットはコードスパンの外へ戻す。
|
|
82
82
|
export function inlineCodeAnglePlaceholders(text) {
|
|
83
|
-
|
|
83
|
+
// HTTP(S) autolink は Markdown として既に安全な山括弧記法なので、プレースホルダとして
|
|
84
|
+
// code span 化しない。register の表セルで bare URL を囲んだ後も autolink を保持する。
|
|
85
|
+
const placeholder = /[A-Za-z0-9._-]*(?:<(?!https?:\/\/)[^<>\r\n]+>[A-Za-z0-9._-]*)+/g;
|
|
84
86
|
const wrapToken = (token) => {
|
|
85
87
|
const trailing = token.match(/\.+$/)?.[0] ?? "";
|
|
86
88
|
const body = trailing ? token.slice(0, -trailing.length) : token;
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Edit Plan: _TASK_ID_
|
|
4
|
+
|
|
5
|
+
## 1. このフェーズで行うこと
|
|
6
|
+
|
|
7
|
+
_PHASE_DESCRIPTION_
|
|
8
|
+
|
|
9
|
+
## 2. 新しく作る実践の型
|
|
10
|
+
|
|
11
|
+
- id: `_AUTHORING_KATA_ID_`
|
|
12
|
+
- kind: `_AUTHORING_KATA_KIND_`
|
|
13
|
+
- path: `_AUTHORING_KATA_PATH_`
|
|
14
|
+
- 記述標準: [[_AUTHORING_STANDARD_ID_|執筆標準]](`_AUTHORING_STANDARD_PATH_`)
|
|
15
|
+
- result: `_RESULT_REF_`
|
|
16
|
+
|
|
17
|
+
手本にする既存成果物:
|
|
18
|
+
|
|
19
|
+
_AUTHORING_EXEMPLARS_
|
|
20
|
+
|
|
21
|
+
手本の成果物は読み取り専用であり、成果物そのものを変更しない。手本がない場合は、記述標準と対象領域の慣行だけを根拠に実践の型を作る。
|
|
22
|
+
|
|
23
|
+
## 3. 進め方
|
|
24
|
+
|
|
25
|
+
1. 記述標準と手本の成果物を実際に読み、複数の成果物に再利用できる規則・問い・完成例・雛形を抽出する。
|
|
26
|
+
2. `_AUTHORING_KATA_PATH_` に `_AUTHORING_KATA_ID_` を持つ `_AUTHORING_KATA_KIND_` を新規作成する。frontmatter の `status` は `draft` とし、`ready` へ変更しない。
|
|
27
|
+
3. 手本の内容を丸写しせず、プロジェクト固有の値を一般化する。手本同士が矛盾する場合は、共通部分と差異を分け、判断できない点を result の申し送りへ記録する。
|
|
28
|
+
4. 手本ごとに、作った種類の参照が `undecided` または未記入なら `_AUTHORING_KATA_ID_` へ更新する。rulebook は成果物カタログの `rulebook`、recipe / sample / template は成果物が参照する rulebook frontmatter の同名フィールドを正本とする。
|
|
29
|
+
5. 参照がすでに別の kata を指す場合は上書きせず、その成果物 ID・既存参照・新しい kata ID を result の申し送りへ記録する。`not-needed` も意図的な判断として上書きしない。
|
|
30
|
+
recipe / sample / template の作成時に、手本の rulebook 自体が `undecided`・未記入・`not-needed` で参照先を記録できない場合は、別種の kata を同時作成せず、付け替え不能として result へ記録する。
|
|
31
|
+
6. 新しい kata と参照の更新だけを変更対象とし、手本の成果物本文は変更しない。
|
|
32
|
+
|
|
33
|
+
## 4. 完了手順
|
|
34
|
+
|
|
35
|
+
1. 新しい実践の型と、条件を満たす参照の更新を完了する。
|
|
36
|
+
2. 共通規約に従って必要な整形・静的検査を実行する。
|
|
37
|
+
3. result に実施内容、変更ファイル、手本、一般化した内容、参照を更新しなかった理由を記録する。
|
|
38
|
+
|
|
39
|
+
## 5. 異常終了の条件
|
|
40
|
+
|
|
41
|
+
- 新しい id が既に存在する、対象種別と id の末尾が一致しない、手本を解決できない、または検査が未解消の場合は異常終了する。
|
|
42
|
+
- 手本の成果物本文へ変更が生じた場合は元に戻し、解消できなければ異常終了する。
|
|
43
|
+
- agent 自身は登録簿の状態を変更しない。
|
|
44
|
+
|
|
45
|
+
_COMMON_CONVENTIONS_
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Edit Plan: _TASK_ID_
|
|
4
|
+
|
|
5
|
+
## 1. このフェーズで行うこと
|
|
6
|
+
|
|
7
|
+
_PHASE_DESCRIPTION_
|
|
8
|
+
|
|
9
|
+
## 2. 新しく作る実践の型
|
|
10
|
+
|
|
11
|
+
- id: `_AUTHORING_KATA_ID_`
|
|
12
|
+
- kind: `_AUTHORING_KATA_KIND_`
|
|
13
|
+
- path: `_AUTHORING_KATA_PATH_`
|
|
14
|
+
- 記述標準: [[_AUTHORING_STANDARD_ID_|執筆標準]](`_AUTHORING_STANDARD_PATH_`)
|
|
15
|
+
- result: `_RESULT_REF_`
|
|
16
|
+
|
|
17
|
+
手本にする既存成果物:
|
|
18
|
+
|
|
19
|
+
_AUTHORING_EXEMPLARS_
|
|
20
|
+
|
|
21
|
+
手本の成果物は読み取り専用であり、成果物そのものを変更しない。手本がない場合は、記述標準と対象領域の慣行だけを根拠に実践の型を作る。
|
|
22
|
+
|
|
23
|
+
## 3. 進め方
|
|
24
|
+
|
|
25
|
+
1. 記述標準と手本の成果物を実際に読み、複数の成果物に再利用できる規則・問い・完成例・雛形を抽出する。
|
|
26
|
+
2. `_AUTHORING_KATA_PATH_` に `_AUTHORING_KATA_ID_` を持つ `_AUTHORING_KATA_KIND_` を新規作成する。frontmatter の `status` は `draft` とし、`ready` へ変更しない。
|
|
27
|
+
3. 手本の内容を丸写しせず、プロジェクト固有の値を一般化する。手本同士が矛盾する場合は、共通部分と差異を分け、判断できない点を result の申し送りへ記録する。
|
|
28
|
+
4. 手本ごとに、作った種類の参照が `undecided` または未記入なら `_AUTHORING_KATA_ID_` へ更新する。rulebook は成果物カタログの `rulebook`、recipe / sample / template は成果物が参照する rulebook frontmatter の同名フィールドを正本とする。
|
|
29
|
+
5. 参照がすでに別の kata を指す場合は上書きせず、その成果物 ID・既存参照・新しい kata ID を result の申し送りへ記録する。`not-needed` も意図的な判断として上書きしない。
|
|
30
|
+
recipe / sample / template の作成時に、手本の rulebook 自体が `undecided`・未記入・`not-needed` で参照先を記録できない場合は、別種の kata を同時作成せず、付け替え不能として result へ記録する。
|
|
31
|
+
6. 新しい kata と参照の更新だけを変更対象とし、手本の成果物本文は変更しない。
|
|
32
|
+
|
|
33
|
+
## 4. 完了手順
|
|
34
|
+
|
|
35
|
+
1. 新しい実践の型と、条件を満たす参照の更新を完了する。
|
|
36
|
+
2. 共通規約に従って必要な整形・静的検査を実行する。
|
|
37
|
+
3. result に実施内容、変更ファイル、手本、一般化した内容、参照を更新しなかった理由を記録する。
|
|
38
|
+
|
|
39
|
+
## 5. 異常終了の条件
|
|
40
|
+
|
|
41
|
+
- 新しい id が既に存在する、対象種別と id の末尾が一致しない、手本を解決できない、または検査が未解消の場合は異常終了する。
|
|
42
|
+
- 手本の成果物本文へ変更が生じた場合は元に戻し、解消できなければ異常終了する。
|
|
43
|
+
- agent 自身は登録簿の状態を変更しない。
|
|
44
|
+
|
|
45
|
+
_COMMON_CONVENTIONS_
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Edit Plan: _TASK_ID_
|
|
4
|
+
|
|
5
|
+
## 1. このフェーズで行うこと
|
|
6
|
+
|
|
7
|
+
_PHASE_DESCRIPTION_
|
|
8
|
+
|
|
9
|
+
## 2. 新しく作る実践の型
|
|
10
|
+
|
|
11
|
+
- id: `_AUTHORING_KATA_ID_`
|
|
12
|
+
- kind: `_AUTHORING_KATA_KIND_`
|
|
13
|
+
- path: `_AUTHORING_KATA_PATH_`
|
|
14
|
+
- 記述標準: [[_AUTHORING_STANDARD_ID_|執筆標準]](`_AUTHORING_STANDARD_PATH_`)
|
|
15
|
+
- result: `_RESULT_REF_`
|
|
16
|
+
|
|
17
|
+
手本にする既存成果物:
|
|
18
|
+
|
|
19
|
+
_AUTHORING_EXEMPLARS_
|
|
20
|
+
|
|
21
|
+
手本の成果物は読み取り専用であり、成果物そのものを変更しない。手本がない場合は、記述標準と対象領域の慣行だけを根拠に実践の型を作る。
|
|
22
|
+
|
|
23
|
+
## 3. 進め方
|
|
24
|
+
|
|
25
|
+
1. 記述標準と手本の成果物を実際に読み、複数の成果物に再利用できる規則・問い・完成例・雛形を抽出する。
|
|
26
|
+
2. `_AUTHORING_KATA_PATH_` に `_AUTHORING_KATA_ID_` を持つ `_AUTHORING_KATA_KIND_` を新規作成する。frontmatter の `status` は `draft` とし、`ready` へ変更しない。
|
|
27
|
+
3. 手本の内容を丸写しせず、プロジェクト固有の値を一般化する。手本同士が矛盾する場合は、共通部分と差異を分け、判断できない点を result の申し送りへ記録する。
|
|
28
|
+
4. 手本ごとに、作った種類の参照が `undecided` または未記入なら `_AUTHORING_KATA_ID_` へ更新する。rulebook は成果物カタログの `rulebook`、recipe / sample / template は成果物が参照する rulebook frontmatter の同名フィールドを正本とする。
|
|
29
|
+
5. 参照がすでに別の kata を指す場合は上書きせず、その成果物 ID・既存参照・新しい kata ID を result の申し送りへ記録する。`not-needed` も意図的な判断として上書きしない。
|
|
30
|
+
recipe / sample / template の作成時に、手本の rulebook 自体が `undecided`・未記入・`not-needed` で参照先を記録できない場合は、別種の kata を同時作成せず、付け替え不能として result へ記録する。
|
|
31
|
+
6. 新しい kata と参照の更新だけを変更対象とし、手本の成果物本文は変更しない。
|
|
32
|
+
|
|
33
|
+
## 4. 完了手順
|
|
34
|
+
|
|
35
|
+
1. 新しい実践の型と、条件を満たす参照の更新を完了する。
|
|
36
|
+
2. 共通規約に従って必要な整形・静的検査を実行する。
|
|
37
|
+
3. result に実施内容、変更ファイル、手本、一般化した内容、参照を更新しなかった理由を記録する。
|
|
38
|
+
|
|
39
|
+
## 5. 異常終了の条件
|
|
40
|
+
|
|
41
|
+
- 新しい id が既に存在する、対象種別と id の末尾が一致しない、手本を解決できない、または検査が未解消の場合は異常終了する。
|
|
42
|
+
- 手本の成果物本文へ変更が生じた場合は元に戻し、解消できなければ異常終了する。
|
|
43
|
+
- agent 自身は登録簿の状態を変更しない。
|
|
44
|
+
|
|
45
|
+
_COMMON_CONVENTIONS_
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Edit Plan: _TASK_ID_
|
|
4
|
+
|
|
5
|
+
## 1. このフェーズで行うこと
|
|
6
|
+
|
|
7
|
+
_PHASE_DESCRIPTION_
|
|
8
|
+
|
|
9
|
+
## 2. 新しく作る実践の型
|
|
10
|
+
|
|
11
|
+
- id: `_AUTHORING_KATA_ID_`
|
|
12
|
+
- kind: `_AUTHORING_KATA_KIND_`
|
|
13
|
+
- path: `_AUTHORING_KATA_PATH_`
|
|
14
|
+
- 記述標準: [[_AUTHORING_STANDARD_ID_|執筆標準]](`_AUTHORING_STANDARD_PATH_`)
|
|
15
|
+
- result: `_RESULT_REF_`
|
|
16
|
+
|
|
17
|
+
手本にする既存成果物:
|
|
18
|
+
|
|
19
|
+
_AUTHORING_EXEMPLARS_
|
|
20
|
+
|
|
21
|
+
手本の成果物は読み取り専用であり、成果物そのものを変更しない。手本がない場合は、記述標準と対象領域の慣行だけを根拠に実践の型を作る。
|
|
22
|
+
|
|
23
|
+
## 3. 進め方
|
|
24
|
+
|
|
25
|
+
1. 記述標準と手本の成果物を実際に読み、複数の成果物に再利用できる規則・問い・完成例・雛形を抽出する。
|
|
26
|
+
2. `_AUTHORING_KATA_PATH_` に `_AUTHORING_KATA_ID_` を持つ `_AUTHORING_KATA_KIND_` を新規作成する。frontmatter の `status` は `draft` とし、`ready` へ変更しない。
|
|
27
|
+
3. 手本の内容を丸写しせず、プロジェクト固有の値を一般化する。手本同士が矛盾する場合は、共通部分と差異を分け、判断できない点を result の申し送りへ記録する。
|
|
28
|
+
4. 手本ごとに、作った種類の参照が `undecided` または未記入なら `_AUTHORING_KATA_ID_` へ更新する。rulebook は成果物カタログの `rulebook`、recipe / sample / template は成果物が参照する rulebook frontmatter の同名フィールドを正本とする。
|
|
29
|
+
5. 参照がすでに別の kata を指す場合は上書きせず、その成果物 ID・既存参照・新しい kata ID を result の申し送りへ記録する。`not-needed` も意図的な判断として上書きしない。
|
|
30
|
+
recipe / sample / template の作成時に、手本の rulebook 自体が `undecided`・未記入・`not-needed` で参照先を記録できない場合は、別種の kata を同時作成せず、付け替え不能として result へ記録する。
|
|
31
|
+
6. 新しい kata と参照の更新だけを変更対象とし、手本の成果物本文は変更しない。
|
|
32
|
+
|
|
33
|
+
## 4. 完了手順
|
|
34
|
+
|
|
35
|
+
1. 新しい実践の型と、条件を満たす参照の更新を完了する。
|
|
36
|
+
2. 共通規約に従って必要な整形・静的検査を実行する。
|
|
37
|
+
3. result に実施内容、変更ファイル、手本、一般化した内容、参照を更新しなかった理由を記録する。
|
|
38
|
+
|
|
39
|
+
## 5. 異常終了の条件
|
|
40
|
+
|
|
41
|
+
- 新しい id が既に存在する、対象種別と id の末尾が一致しない、手本を解決できない、または検査が未解消の場合は異常終了する。
|
|
42
|
+
- 手本の成果物本文へ変更が生じた場合は元に戻し、解消できなければ異常終了する。
|
|
43
|
+
- agent 自身は登録簿の状態を変更しない。
|
|
44
|
+
|
|
45
|
+
_COMMON_CONVENTIONS_
|
|
@@ -338,6 +338,38 @@ npx specdojo-docs-site build .
|
|
|
338
338
|
|
|
339
339
|
開発サーバは `npx specdojo-docs-site dev .` で起動します。`build` と `dev` は、利用リポジトリに存在しない package 同梱の kata・guide・reference を、gitignore 済みの `specdojo-kata-staging/` へ一時的に複製して `/ja/specdojo/` で配信します。eject 済みの文書は利用リポジトリ側を優先するため、サイト表示のために `kata install --all` を実行する必要はありません。
|
|
340
340
|
|
|
341
|
+
### 6.1. Mermaid 図を組み立てる
|
|
342
|
+
|
|
343
|
+
docs-site の Mermaid 12 は、既定のレイアウトに ELK を使います。ELK は複雑な図でも要素を層に分け、辺を直角に配線するため、通常は図ごとのレイアウト指定を加えません。既存の図が `config` で `dagre` を指定している場合は、その図の意図を優先します。`elk.stress` など ELK の別方式は要素が重なることがあるため使いません。
|
|
344
|
+
|
|
345
|
+
1 つの図の辺が 20 本前後を超える場合は、目的ごとに図を分けるか、`subgraph` で関係のまとまりを示します。中心の要素に周囲から矢印を集める図は、`architecture` 図を使うと辺ごとに接続面を指定できます。`T` は上、`B` は下、`L` は左、`R` は右です。
|
|
346
|
+
|
|
347
|
+
```mermaid
|
|
348
|
+
architecture-beta
|
|
349
|
+
service top(cloud)[上]
|
|
350
|
+
service bottom(database)[下]
|
|
351
|
+
service left(internet)[左]
|
|
352
|
+
service right(disk)[右]
|
|
353
|
+
service center(server)[中心]
|
|
354
|
+
|
|
355
|
+
top:B --> T:center
|
|
356
|
+
bottom:T --> B:center
|
|
357
|
+
left:R --> L:center
|
|
358
|
+
right:L --> R:center
|
|
359
|
+
```
|
|
360
|
+
|
|
361
|
+
Mermaid 12.0.0 の `architecture` 図では、辺にラベルを付けられません。関係の名前を示す場合はノード名へ含めるか、辺ラベルを使える `flowchart` で描きます。`architecture` 図の組み込みアイコンは `cloud`・`database`・`disk`・`internet`・`server` です。それ以外の Iconify アイコンは表示側でアイコンパックの登録が必要なため、登録していない環境では使いません。
|
|
362
|
+
|
|
363
|
+
要素を格子状に並べる図には `block` 図を使えます。要素が詰まりやすいため、空けたい 1 列には `space`、複数列には `space:<列数>` を置きます。
|
|
364
|
+
|
|
365
|
+
```mermaid
|
|
366
|
+
block
|
|
367
|
+
columns 3
|
|
368
|
+
a["A"] space b["B"]
|
|
369
|
+
space center["中心"] space
|
|
370
|
+
c["C"] space d["D"]
|
|
371
|
+
```
|
|
372
|
+
|
|
341
373
|
サイト上の情報量を抑えるため、ナビゲーションと検索には次の範囲を使います。
|
|
342
374
|
|
|
343
375
|
- `/ja/specdojo/` では SpecDojo 文書、`/ja/projects/<project-id>/` では対象 project の文書をサイドバーに表示します。
|
|
@@ -381,7 +381,7 @@ VS Code でプロジェクトリポジトリとプロダクトリポジトリを
|
|
|
381
381
|
|
|
382
382
|
プロダクト文書は実装と同期して改訂するため、`app1/docs/ja/product/` に置きます。README、ソースコードから生成する API リファレンス、パッケージ利用者向けの手順など、コードと同じ revision で読む付属文書も `app1/` に置きます。
|
|
383
383
|
|
|
384
|
-
`app1-specdojo/` には `docs/ja/projects/` と `docs/ja/specdojo/`
|
|
384
|
+
`app1-specdojo/` には `docs/ja/projects/` と `docs/ja/specdojo/` を置きます。前者はプロジェクト固有の目的・判断・計画・実行記録、後者は SpecDojo が配布する型と、種類ディレクトリ配下の authority サブディレクトリに置く利用者作成の rulebook / recipe / sample / template です。この境界により、プロダクトの内容と同じ revision が必要な文書は `app1/`、SpecDojo の記帳と再利用可能な型は `app1-specdojo/` の履歴に残ります。
|
|
385
385
|
|
|
386
386
|
プロダクト文書の catalog `base_path` を別リポジトリへ解決する機能と、[[prj-0001:pjr-xkks-grade-sidecar|PJR-XKKS grade result のサイドカー化]] で定める成果物へ書き込まない grade 運用は、プロダクト文書を成果物として管理する場合の前提です。exec はプロダクト文書をファイルとして変更・統合できますが、catalog・grade・doc index の対象にはしません。
|
|
387
387
|
|
|
@@ -87,6 +87,8 @@ phase_sets:
|
|
|
87
87
|
|
|
88
88
|
`approach` の値ごとの意味と、rulebook / recipe / sample / template の参照方針は [実践の進め方ガイド](ryu-guide.md) を参照します。
|
|
89
89
|
|
|
90
|
+
`*-authoring` は register の `--target` 順序で新規 kata ID と手本を表すため、Schedule の phase では使用できません。strategy に指定すると plan 生成時に停止します。
|
|
91
|
+
|
|
90
92
|
pipeline では `agent_pipeline.stages` を `executor`、`reporter` の順に定義します。各 stage は `stage_role` と任意の `capabilities` / `proficiency` を持ちます。特定 member を使う phase は、これと併せて `agent.executor` / `agent.reporter` を指定します。pipeline の構造例は [Schedule設計ガイド](schedule-design-guide.md) の `executor / reporter pipeline` を参照してください。
|
|
91
93
|
|
|
92
94
|
解決順序は `--executor-by` / `--reporter-by`、phase の `agent`、`capabilities` / `proficiency` / `priority` による自動選択です。CLI は緊急の差し替えに使います。指定した member は対応する `stage_role` を持つ必要があり、`schedule build` が phase の nickname と role を検証します。従来の単一 agent タスクでは stage override を使用できません。
|
|
@@ -534,12 +536,12 @@ executor の出力は、そのまま reporter へ渡さずに run 単位の evid
|
|
|
534
536
|
|
|
535
537
|
agent が exec 実行時に読み込む provider 固有の設定(agent 定義・permission 設定)は、npm package 内の `templates/<provider>/` を配布原本とし、利用プロジェクトへコピーして使います。worktree 実行はコミット済み内容から worktree を作るため、コピーした設定は必ずコミットします。
|
|
536
538
|
|
|
537
|
-
配置規則は provider 名から機械的に決まります(`agents/` 配下 → `.<provider>/agents/`、それ以外のファイル → `.specdojo/<provider>/`、`README.md` はコピーしません)。provider ごとの配布内容は次のとおりです。
|
|
539
|
+
配置規則は provider 名から機械的に決まります(`agents/` 配下 → `.<provider>/agents/`、`rules/` 配下 → `.<provider>/rules/`、それ以外のファイル → `.specdojo/<provider>/`、`README.md` はコピーしません)。provider ごとの配布内容は次のとおりです。
|
|
538
540
|
|
|
539
541
|
| provider | 配布内容 | 配置先 |
|
|
540
542
|
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
|
|
541
|
-
| claude | `agents/*.md`(役割ごとの agent 定義)、`settings.edit.json` / `settings.review.json` / `settings.report.json`
|
|
542
|
-
| codex | `agents/*.toml`(親 Codex が spawn する subagent
|
|
543
|
+
| claude | `agents/*.md`(役割ごとの agent 定義)、`settings.edit.json` / `settings.orchestrator.json` / `settings.review.json` / `settings.report.json` | `.claude/agents/`、`.specdojo/claude/` |
|
|
544
|
+
| codex | `agents/*.toml`(親 Codex が spawn する subagent 定義)、`rules/*.rules`(command rule) | `.codex/agents/`、`.codex/rules/` |
|
|
543
545
|
| opencode | `agents/*.md`(permission frontmatter 込みの agent 定義) | `.opencode/agents/` |
|
|
544
546
|
| copilot | `agent-members-snippet.yaml`(agent 定義)と `exec-defaults-snippet.yaml`(`providers.copilot` の command template・rate limit 検出)の参照スニペット | `.specdojo/copilot/` |
|
|
545
547
|
| antigravity | `orchestrator.md`、agent / provider 設定スニペット。`settings.global.json` は `--global` 用のマージ原本であり repository へは配置しない | `.specdojo/antigravity/` |
|
|
@@ -552,6 +554,8 @@ Claude member の `mode` はこの `{mode}` を権限プロファイル名へ展
|
|
|
552
554
|
|
|
553
555
|
`settings.edit.json` は、利用者のリポジトリ固有の構成(ルート直下の成果物や `app/`・`lib/` など)にも対応できるよう、既定でリポジトリ全体への Edit を許可します。一方、agent の権限や親 runner・hook・CI の実行内容を変更できる `.specdojo/`、agent 設定、CI 設定、ルート直下の `package.json` などは deny します。deny の範囲は runner の agent-config-write 検査と同じ保護対象を unit test で照合し、Claude Code の事前拒否と runner の事後検査を重ねます。
|
|
554
556
|
|
|
557
|
+
`settings.orchestrator.json` は `init` と `config scaffold` が追加する `orch:opus`・`orch:sonnet` 専用です。対話型オーケストレーターは利用者の承認を得て保護設定も変更するため、`settings.edit.json` のパス deny を引き継ぎません。代わりに `git push` と GitHub CLI の書き込み操作を deny し、PR・workflow run・release などの読み取りコマンドだけを allow します。
|
|
558
|
+
|
|
555
559
|
### 7.1. scaffold コマンド
|
|
556
560
|
|
|
557
561
|
この配置は、初期設定の導線にある `config scaffold` の `--provider <name>` オプションで自動化します。
|
|
@@ -622,9 +626,9 @@ provider によらず、exec の実行構造そのものが次の境界を提供
|
|
|
622
626
|
|
|
623
627
|
### 8.2. provider 別の権限設定
|
|
624
628
|
|
|
625
|
-
**claude** は `provider 設定の配布と scaffold`
|
|
629
|
+
**claude** は `provider 設定の配布と scaffold` のとおり、pipeline のロール別 `--settings` でパス単位に制限します。executor・review executor・reporter は `git push` と全 `gh` を deny します。対話型オーケストレーターの npm script は専用の `settings.orchestrator.json` を読み込み、保護設定を含む編集を妨げず、`git push` と `gh` の書き込みだけを deny して読み取りを allow します。`--permission-mode bypassPermissions` は使わず、`.claude/settings.json` の `disableBypassPermissionsMode: "disable"` で起動自体を拒否します。
|
|
626
630
|
|
|
627
|
-
**antigravity** は `config scaffold --provider antigravity --global` で fine-grained permission を追記します。グローバル設定は利用者のすべてのリポジトリに効くため、allow は読み取りの Git コマンド(`git status` / `diff` / `log` / `show`)だけとし、`npm run` など任意のスクリプトを実行できる command は含めません。deny
|
|
631
|
+
**antigravity** は `config scaffold --provider antigravity --global` で fine-grained permission を追記します。グローバル設定は利用者のすべてのリポジトリに効くため、allow は読み取りの Git コマンド(`git status` / `diff` / `log` / `show`)だけとし、`npm run` など任意のスクリプトを実行できる command は含めません。deny には、`git push`、全 `gh`、Git の変更操作・破壊的 command・秘密情報・固定保護設定へのアクセスを入れます。`--dangerously-skip-permissions` は使いません。CLI の permission に加えて、実行後の provider 非依存ガードでも保護設定の変更を block します。
|
|
628
632
|
|
|
629
633
|
**codex** はパス単位の permission 機構を持たず、sandbox(`read-only` / `workspace-write` / `danger-full-access`)の粒度で制御します。review でも result の記入が必要なため `read-only` にはできず、edit / review とも `workspace-write` を使います。command template には次を明示します。
|
|
630
634
|
|
|
@@ -642,6 +646,7 @@ providers:
|
|
|
642
646
|
- `-c sandbox_workspace_write.network_access=false`: sandbox 内からの直接のネットワークアクセスを遮断します。デフォルトでも無効ですが、設定変更で意図せず解放されないよう command に固定します。`web_search` はモデル側ツールとして sandbox の外で動作するため、この設定の影響を受けません。
|
|
643
647
|
- `--ephemeral`: セッションを永続化せず、実行間の文脈持ち越しを防ぎます。
|
|
644
648
|
- `.codex/config.toml` は対話セッション用のデフォルト(`approval_policy = "on-request"` 等)であり、無人実行の権限は command template の `-c` 上書きを正とします。claude の `settings.local.json`(対話用)と `--settings`(無人実行用)の分担に対応します。
|
|
649
|
+
- scaffold は `.codex/rules/specdojo.rules` も配置し、`git push` と全 `gh` を `forbidden` にします。無人実行では network 無効化と重ね、対話セッションでも共有された GitHub 認証を agent が使わない境界にします。project-local rule は信頼済み project で読み込まれます。
|
|
645
650
|
|
|
646
651
|
**opencode** は agent 定義(`.opencode/agents/*.md`)の frontmatter `permission` を正とします。claude の settings と同等以上の粒度(パス単位の `edit`、コマンドパターン単位の `bash`)を持つため、両 agent とも許可リスト方式で定義します。
|
|
647
652
|
|
|
@@ -651,7 +656,9 @@ providers:
|
|
|
651
656
|
| opencode-review-executor | 全面 deny(成果物・result のいずれも変更しない) | 読み取り系・検証系の許可リスト。他は deny |
|
|
652
657
|
| opencode-reporter | 全面 deny(result への反映は runner が行う) | 全面 deny |
|
|
653
658
|
|
|
654
|
-
`bash` を deny 基点の許可リストにするのは、`git add` / `git commit` を含む任意コマンドを塞ぐためで、denylist(`git push`
|
|
659
|
+
`bash` を deny 基点の許可リストにするのは、`git add` / `git commit` を含む任意コマンドを塞ぐためで、denylist(`git push` などの列挙)では不十分です。executor・review executor は、将来の許可リスト追加で意図せず開かないよう `git push` と全 `gh` を末尾でも明示 deny します。対話型オーケストレーターは agent 定義ごとに権限を分離できるため、`edit` をリポジトリ全体で allow し、PR・workflow run・release などの読み取りだけを allow します。`gh api` と書き込みサブコマンドは明示 deny し、それ以外は先頭の deny により拒否されます。
|
|
660
|
+
|
|
661
|
+
Codex の project-local rule と Antigravity の global settings は役割共通であり、同じリポジトリまたは利用者の orchestrator だけを例外にできません。この 2 provider は全 agent の `gh` 全面拒否を維持します。Claude と OpenCode は orchestrator 専用設定を持てるため読み取りだけを許可し、pipeline executor・reporter は全 `gh` を拒否します。
|
|
655
662
|
|
|
656
663
|
**copilot**(GitHub Copilot CLI)は command のフラグで権限を制御します。deny は allow より常に優先され、`--allow-all-tools` すら上書きできます。`.specdojo/agent-members.yaml` には copilot member を `disabled: true` で定義し、起動コマンドは `providers.copilot.command_template` に定義します。有効化する際も次の構成を維持します。
|
|
657
664
|
|
|
@@ -65,6 +65,12 @@ template は、記述する部分を _TODO_ などのプレースホルダとし
|
|
|
65
65
|
|
|
66
66
|
要否は初回の `bootstrap` で判断します。`undecided` の型は、必要なら項目を省略したうえで必要な型を成果物と一緒に整備し、不要なら `not-needed` へ更新します。既存の型を廃止する、または `not-needed` を必要へ変更する場合は、成果物の実績・繰り返し発生したレビュー指摘・schema の表現範囲を根拠として rulebook frontmatter の宣言も同時に更新します。
|
|
67
67
|
|
|
68
|
+
成果物と型を一組で初めて作るときは `bootstrap` を使います。成果物がすでにあり、そこから再利用可能な型だけを新しく起こすとき、または手本なしで型だけを作るときは `rulebook-authoring` / `recipe-authoring` / `sample-authoring` / `template-authoring` を使います。authoring では手本の成果物本文を変更せず、該当参照が `undecided` または未記入の場合だけ新しい kata ID へ更新します。
|
|
69
|
+
|
|
70
|
+
利用者が作る kata はリポジトリ単位の `kata_authority` を使い、`docs/ja/specdojo/{rulebooks,recipes,samples,templates}/<kata_authority>/` に置きます。たとえば `customer:payment-rulebook` の配置は `docs/ja/specdojo/rulebooks/customer/payment-rulebook.md` です。`specdojo:` は SpecDojo 本体専用であり、利用者リポジトリでは新規作成できません。これにより、同じリポジトリの複数 project で型を共有しながら、将来追加される同名の同梱 kata と衝突しません。
|
|
71
|
+
|
|
72
|
+
0.4.4 のあいだは旧 `docs/ja/kata/` 配置も読みますが、解決時に新配置への移動案内を出します。同じ ID が新旧の両方にある場合は authority サブディレクトリ側を使い、旧ファイルの削除を案内します。
|
|
73
|
+
|
|
68
74
|
`kind: generated` の成果物には実践の型を適用しません。成果物ごとの型宣言は置かず、`kind` から非適用を導出します。rulebook を持たない成果物は成果物カタログの `rulebook: not-needed` で表します。
|
|
69
75
|
|
|
70
76
|
## 3. 進め方(approach)との参照分担
|
|
@@ -35,12 +35,16 @@ SpecDojo は、成果物(プロダクトとプロジェクトの内容その
|
|
|
35
35
|
|
|
36
36
|
npm package が所有する型の文書は、package ごとの authority を ID に付けます。SpecDojo core は `specdojo:`、業界固有の variant package は `construction-dojo:` などを使用します。authority は論理IDにだけ含め、ファイル名には含めません。利用プロジェクトへコピーした標準文書を override する場合は同じ完全IDを維持し、独自文書を追加する場合は別IDを付けます。
|
|
37
37
|
|
|
38
|
+
配置は SpecDojo core が `docs/ja/specdojo/<種類>s/<local-id>.<拡張子>`、それ以外が `docs/ja/specdojo/<種類>s/<authority>/<local-id>.<拡張子>` です。利用者リポジトリと variant package は同じ authority サブディレクトリ形式を使うため、育てた kata を ID とパスを変えずに package へ移せます。
|
|
39
|
+
|
|
38
40
|
### 1.1. npm package からの参照と eject
|
|
39
41
|
|
|
40
42
|
SpecDojo core の rulebook / standard / recipe / sample / template は、npm package に同梱されたものを既定で参照します。プロジェクト固有の変更が必要な文書だけを利用リポジトリの同じ相対パスへ eject し、同じ完全 ID を維持して上書きします。
|
|
41
43
|
|
|
42
44
|
文書 ID のインデックスは、利用リポジトリの `docs/` と、resolver が返す package ルート配下の上記 5 種別のディレクトリを別スコープとして走査します。同一スコープ内で同じ ID が複数のファイルにあればエラーです。利用リポジトリと package の間で同じ ID がある場合は正常な override として利用リポジトリ側を採用します。どちらにも存在しない ID は未解決のままです。
|
|
43
45
|
|
|
46
|
+
0.4.4 では移行互換として旧 `docs/ja/kata/<種類>s/` も読みます。旧配置を見つけた場合は authority サブディレクトリへの移動を案内し、新旧に同じ ID がある場合は新配置を優先して警告します。
|
|
47
|
+
|
|
44
48
|
package の探索では `node_modules` 全体を再帰走査せず、resolver が返した SpecDojo package の対象ディレクトリだけを読みます。この解決結果は CLI の wikilink とカタログ検証に使います。VitePress で package 側文書を配信するためのステージングは、docs サイトのビルド責務として別に扱います。
|
|
45
49
|
|
|
46
50
|
## 2. 種別と役割
|