[deep-report] Add a schema-to-docs parity test for reference/frontmatter.md
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 84/100
- issue の種類
- 機能追加
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- go
- 領域
- documentation, testing
調査の方向性
pkg/parser/schemas/main_workflow_schema.json と docs/src/content/docs/reference/frontmatter.md を読み、スキーマのプロパティとページ内のバッククォートで囲まれた name: 参照を理解してください。トップレベルの各プロパティがドキュメント化されていることを確認する Go テストを追加し、allowlist に含める例外にはコメントで理由を記述してください。現在のフィールドでテストがパスし、ドキュメント化されていないスキーマフィールドが導入された場合に失敗すれば完了です。
索引モデルが issue の本文から書いたものです。
説明
Description
Nothing currently guards against the frontmatter reference page drifting from pkg/parser/schemas/main_workflow_schema.json — the audit that found 11 undocumented fields (see the companion docs issues from this same analysis) had to be done manually. Add a Go test that loads the top-level properties of main_workflow_schema.json and asserts each appears as a backticked `name:` reference in docs/src/content/docs/reference/frontmatter.md. Keep a small, justified allowlist for genuinely internal/deprecated fields (each allowlist entry needs a comment explaining why it's exempt).
Expected Impact
Prevents this exact gap from recurring: any future schema field added without a corresponding docs update fails CI immediately instead of silently drifting for months.
Suggested Agent
GitHub Copilot coding agent (Go test + parser package).
Estimated Effort
Medium (1-4 hours)
Data Source
DeepReport Intelligence Briefing — 2026-09-30, sourced from Repository Quality Improvement Report #64505 (Task 3, marked High priority by the source report).
Generated by 🔬 Deep Report · claude · agent · 311.3 AIC · ⌖ 8.86 AIC · ⊞ 7.3K · ◷
- expires on Oct 2, 2026, 10:46 AM UTC-08:00
- 主要言語
- Go
- スター
- 5.4k
- フォーク
- 584
- 平均マージ
- 3時間 20分
- マージ済み PR（30日）
- 830
環境構築
このプロジェクトの開発コンテナを、あなたの GitHub アカウントでブラウザ上に起動します。
- Dockerfile または Docker Compose ファイルあり
- プルリクエストのテンプレートなし
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
github/gh-aw のほかの issue
-
agent-research
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
メンテナーはふだん 1 日以内に返信
-
cookie sergo
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
メンテナーはふだん 1 日以内に返信
-
ai-inspected
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
メンテナーはふだん 1 日以内に返信
-
goroutineresourceleak (81st linter): paren_unwrap_gap across lock/cancel/channel detection, day oneオープンcookie sergo
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
github/gh-aw#68591 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
automation models
難易度 1/5 1時間未満 初心者へのやさしさ 1/100
メンテナーはふだん 1 日以内に返信
似ている issue
-
Chained slog With calls discard previously bound attributes対応中かも @yuefdev が今日担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
メンテナーはふだん 1 日以内に返信
-
[scanner] TestAgentNowLineStates hard-fails instead of degrading when node is off PATH対応中かも @arteeh が今日担当しました。 オープンagent/scanner ci help wanted kind/test
難易度 1/5 1時間未満 初心者へのやさしさ 90/100
hivecommons/hive#12924 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
Gentleman-Programming/engram#1940 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
cloudflare/terraform-provider-cloudflare#7423 ·
メンテナーはふだん 1 日以内に返信
-
devices
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
evcc-io/evcc#35007 · コメント 7 件 ·
メンテナーはふだん 1 日以内に返信