Skip to content

docs(knowledge): document routines create body field capability boundaries#233

Merged
ozzy-3 merged 1 commit into
mainfrom
docs/routines-create-body-field-boundaries
May 24, 2026
Merged

docs(knowledge): document routines create body field capability boundaries#233
ozzy-3 merged 1 commit into
mainfrom
docs/routines-create-body-field-boundaries

Conversation

@ozzy-3
Copy link
Copy Markdown
Contributor

@ozzy-3 ozzy-3 commented May 24, 2026

概要

knowledge/ai/agents/claude-code-routines.mdcreate body のフィールド能力境界 を追記する。Closes #232

/schedule の create が叩く POST /v1/code/triggers の body は strict schema(未知フィールドを reject)。どの設定が CLI/API で入り、どれが Web UI 専用かが未記載で実運用の誤解を生んでいたため、実測(2026-05-24)に基づき明文化する。

変更内容

  • 新規小節「create body のフィールド能力境界」 を CLI (/schedule) セクション直後に追加
    • CLI/API で設定可能なフィールド一覧(model / instructions / 対象リポ / allowed_tools / environment / cron・run_once_at・enabled・mcp_connections)とその create body 内パスを表で明記
    • Web UI 専用フィールド allow_unrestricted_git_push を明記。create body に渡すと HTTP 400 allow_unrestricted_git_push: Extra inputs are not permitted で reject される実測レスポンスを掲載
    • 「instructions / model は Web UI 専用」という誤解への反証を明記
  • 「AI エージェントがよくやるミス」に項目 9 を追加allow_unrestricted_git_push を create body に渡せると誤解 → strict schema で 400

既存記述(delete Web-only / network Default=Trusted / trigger 種別)は正確なため変更なし。

検証

  • markdownlint: 0 error
  • vitest: 77 passed
  • INDEX 再生成: 差分なし(frontmatter 未変更)

🤖 Generated with Claude Code

…aries

Add a section clarifying which create body fields are settable via
CLI/API (model, instructions, repo, allowed_tools, environment,
cron/run_once_at/enabled/mcp_connections) versus Web UI only.
Document that allow_unrestricted_git_push is rejected by the strict
create schema (HTTP 400 Extra inputs are not permitted) and can only
be set in the Web UI Permissions, refuting the misconception that
instructions/model are Web UI only.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@ozzy-3
Copy link
Copy Markdown
Contributor Author

ozzy-3 commented May 24, 2026

レビュー結果 (mode: quick, axes: correctness, security, conventions, documentation, usability):

適用観点 (5/11):
required: correctness, security, conventions
ux: documentation, usability
(skip: architecture/maintainability/testing/performance/observability/compatibility — docs-only diff)

correctness

指摘なし。追加したフィールドパス(job_config.ccr.session_context.model 等)と 400 エラー文言は Issue #232 の live probe 実測と一致。allow_unrestricted_git_push(既存ブランチへの push 許可)の説明も記事既存記述(主要機能の "Allow unrestricted branch pushes")と整合。

security

指摘なし。追加箇所は 400 エラーレスポンス例のみでシークレット混入なし。

conventions

指摘なし。fenced code に text 言語指定あり、markdownlint 0 error、コミット docs(knowledge): は Conventional Commits 準拠。

documentation

指摘なし(本変更の主目的)。create body の能力境界が公開挙動と同期され、既存記事構成に整合。
[Info] knowledge/ai/agents/claude-code-routines.md
問題: ai/practice/scheduled-tasks.md へのクロスリンクは未追加(Issue で任意とされた項目)。
提案: 必要なら follow-up で相互リンクを足す。drive loop では修正対象外(Info)。

usability

指摘なし。表 + 誤解への反証で能力境界が一読で把握できる。

サマリー

Critical: 0 件
Warning: 0 件
Info: 1 件

by_axis:
correctness: C0 W0 I0
security: C0 W0 I0
conventions: C0 W0 I0
documentation: C0 W0 I1
usability: C0 W0 I0

@ozzy-3 ozzy-3 merged commit 66a849e into main May 24, 2026
3 checks passed
@ozzy-3 ozzy-3 deleted the docs/routines-create-body-field-boundaries branch May 24, 2026 12:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant