specline 0.1.0

SpecLine CLI for managing specline/ OpenSpec workflows

SpecLine

Python 実装の SpecLine CLI（コマンド名 specline / 互換エイリアス palprompt）です。OpenSpec の openspec/ ワークフローを specline/ ディレクトリへ移行し、AI アシスタント用プロンプトを一元管理します。

セットアップ

1. パッケージをインストール
   • pip を直接使う場合

     pip install specline
     # 開発モードなら
     pip install -e .[test]
     

   • uv を使用する場合

     uv pip install specline
     # 開発モードなら
     uv pip install -e .[test]
     

2. 以上でセットアップ完了です。CLI から specline --help を実行してインストールを確認してください。

使い方

• プロジェクト初期化

  specline init  # 旧: palprompt init
  

  実行すると以下を行います:

• specline/ 以下に project.md、AGENTS.md、specs/、changes/、prompts/ を生成

  • LANG などのロケール情報から日本語が検出された場合は specline-*.md が日本語版で展開され、それ以外は英語版が展開されます（ファイル名への言語サフィックスは付きません）
  • .claude/commands/specline/ など各 AI アシスタント向けフォルダへプロンプトをコピー（Codex は CODEX_HOME/prompts、環境変数がなければ ~/.codex/prompts/ を使用。ホームが取得できない環境のみリポジトリ内 .codex/prompts/ へ格納）
  • 既存の openspec/ があれば AGENTS.md、project.md、specs/、changes/ を specline/ に移行
  • 実行時にインストール対象ツール（Claude/Cursor/GitHub/Codex/ローカル specline）を尋ねます。Enter で全選択、--assistants cursor,codex のように指定してスクリプト化も可能です。
  • --update-root-agents を付けると、リポジトリ直下の AGENTS.md も specline/AGENTS.md を参照する最新テンプレートに置き換えられます。
  • --assistants claude,cursor,codex のように指定すると、対象ツールのみ（既定: claude/cursor/github/specline/codex）へプロンプトを配置できます。Codex は CODEX_HOME（未設定時はリポジトリ内 .codex/）以下にインストールされます。

• テンプレート更新

  specline update  # 旧: palprompt update
  

  specline/prompts/ を最新テンプレートで上書きし、各 AI アシスタント用フォルダにも同期します。--assistants で対象ツールを絞り込むことも可能です。新しい言語ファイルを追加した場合もこのコマンドで展開できます。

• 生成されるディレクトリ構成

  specline/
  ├── project.md
  ├── AGENTS.md
  ├── prompts/
  ├── specs/
  └── changes/
  

カスタムプロンプトと推奨使用順序

SpecLine が提供する specline-*.md は以下の 6 種類です。通常はロードマップ策定からアーカイブ完了まで、この順番で AI に依頼します。

プロンプト	主な出力内容	推奨タイミング
specline-concept	docs/concept.md を ## Concept Summary → ## CLI vs Prompt Responsibilities → ## Localisation Strategy → ## specline/ Directory Structure の構成で更新	プロジェクト初期 / 大きな方針変更時
specline-roadmap	`	Milestone
specline-propose	proposal / tasks / spec を規定の章構成で作成し、specline validate {change_id} 実行結果を proposal に追記	各 change-id の着手時
specline-apply	Task Status / Commands and Tests / specline validate Results / Next Actions の 4 セクションで進捗報告	実装中の週次報告・レビュー前
specline-archive	タスク完了確認、デルタ要約、検証ログ、最終コマンド列、リリースノート。日本語環境では docs/ に日英 2 文書を生成	change 完了時
specline-update	Directories Updated / File Differences / Verification の 3 セクションでテンプレ更新作業を記録	specline update 実行時

Note: specline/OpenSpec の archive プロンプトは docs や specs への変更を自動適用しません。チェックリストとデルタ表を確認しながら、最終的なドキュメント反映は開発者が手動で行う運用になっています。

全体フロー

1. 概念整理 – specline-concept でプロジェクトの目的や CLI/プロンプトの責務、ローカライズ方針を固め、docs/concept.md を最新化します。
2. マイルストーン設計 – specline-roadmap で機能をフェーズ分割し、Milestone 表と依存関係・リスクを明確にします。
3. フェーズ実行 (繰り返し)
   • specline-propose で各フェーズの proposal/tasks/spec を生成し、specline validate を通した状態にします。
   • 実装中は specline-apply を定期的に使って進捗・テスト結果・次のアクションを共有します。
   • フェーズ完了時に specline-archive を実行し、タスク完了/デルタ要約/検証ログ/最終コマンドをまとめます（日本語環境では docs/ に日英 2 文書を作成）。
     これらのアウトプットをもとに、最終的な docs/specs 更新は AI アシスタントやチームが手動で反映します。
4. テンプレ維持 – プロンプトテンプレートや各ツールへの配布内容を更新した際は specline-update で差分と検証手順を記録し、specline update を再実行します。

テストカバレッジ

tests/test_cli_init.py では以下を検証します:

• specline init（および互換エイリアス palprompt init）がディレクトリとテンプレートを生成するか
• LANG に応じてローカライズ済みプロンプトが作成されるか
• 既存 openspec/ の仕様が specline/ へ移行されるか
• 選択したツール（Claude/Cursor/Codex など）のフォルダにプロンプトが同期されるか

今後の予定

• specline CLI の追加サブコマンド（list / validate / archive など）
• specline/prompts/ テンプレートの拡充と多言語サポート強化
• README にチュートリアル例やベストプラクティスの追加