Skip to content

docs: tq / tqdev コマンドガイダンスを再整理 - #317

Merged
version-1 merged 3 commits into
mainfrom
worktrees/1-reorganize-tq-command-docs
Aug 15, 2026
Merged

docs: tq / tqdev コマンドガイダンスを再整理#317
version-1 merged 3 commits into
mainfrom
worktrees/1-reorganize-tq-command-docs

Conversation

@version-1

Copy link
Copy Markdown
Owner

tq / tqdev コマンドガイダンスの再整理

Summary

PR #316 で更新した6つの英日ドキュメントをファイル単位で見直し、ビルドプロファイルによるコマンド解決とプロンプト注入の説明を整理します。コマンド解決の正本を System Prompts に集約し、Workflow Contract から重複説明を除去します。

主な変更点:

  • tq / tqdev の選択、PATH 要件、開発用ガイダンスを System Prompts に集約
  • Workflow Contract はテンプレート契約と管理下実行の制約に絞り、System Prompts への導線を追加
  • 英語正本と日本語版を同期し、日本語版の一般語表記を整理

やったこと

  • 初回ターンと継続ターンで異なる開発用ガイダンスの注入条件を明文化
  • 固定の tq 実行例をプロファイル中立なサブコマンド表記へ変更
  • Makefile Reference の開発ビルド説明を管理対象サービスという用語へ統一
  • docs/symphony/SPEC.md は変更せず、Tasq 固有の契約文書だけを整理

動作確認

  • git diff --check origin/main...HEAD
  • 変更した相対リンクの参照先が存在することを確認
  • go test ./internal/orchestrator/runner ./internal/config ./internal/cli/tq
  • docs/symphony/SPEC.md が未変更であることを確認

レビュー & 動作確認 チェックリスト

  • 英日同期 - 英語正本と日本語版で契約の意味が一致していること
  • 責務分離 - コマンド解決の詳細が System Prompts に集約されていること
  • 実装整合 - PR refactor(orchestrator): resolve tq command from build profile #316 で導入したビルドプロファイルとプロンプト注入の挙動に一致すること

推奨テスト計画:

  1. System Prompts のコマンド解決節と初回・継続プロンプト節を通読する。
  2. Workflow Contract の {{ tq.command }} とタスク作業プロンプト設定から System Prompts への導線を確認する。
  3. 英語版と日本語版の対応する節・表を比較する。

その他気になることや相談ごと

PR #316main へマージ済みです。このPRは文書整理のみを含みます。

Centralize build-profile command resolution in the system prompt reference and remove duplicated tracker guidance from the workflow contract. Keep the English and Japanese references synchronized and clarify the tqdev build requirement.\n\nVerification: git diff --check
Avoid hard-coded tq examples in managed-run guidance, clarify when development prompt guidance is injected, and normalize general terminology in the Japanese workflow contract.\n\nVerification: git diff --check
Describe service startup without hard-coding tq, distinguish initial and continuation guidance conditions, and finish terminology cleanup in the Japanese workflow contract.\n\nVerification: git diff --check
@version-1
version-1 merged commit 4acd63b into main Aug 15, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant