Skip to content

TASK.codex.md

Latest commit

 

History

History
129 lines (90 loc) · 2.24 KB

TASK.codex.md

File metadata and controls

129 lines (90 loc) · 2.24 KB
intent_id INT-001
owner agent-taskstate-team
status active
last_reviewed_at 2025-03-07
next_review_due 2025-04-07

agent-taskstate Task Seed Template

メタデータ

task_id: YYYYMMDD-xx
repo: https://github.com/owner/agent-taskstate
base_branch: main
work_branch: feat/short-slug
priority: P1|P2|P3
langs: [python]

Objective

{{一文で目的}}

Scope

  • In: {{対象(ディレクトリ/機能/CLI)を箇条書き}}
  • Out: {{非対象(触らない領域)を箇条書き}}

Requirements

  • Behavior:
    • {{期待挙動1}}
    • {{期待挙動2}}
  • I/O Contract:
    • Input: {{型/例}}
    • Output: {{型/例}}
  • Constraints:
    • JSON契約 {ok, data, error} 遵守
    • typed_ref 形式使用
    • Lint/Type/Test はゼロエラー
  • Acceptance Criteria:
    • {{検収条件1}}
    • {{検収条件2}}

Affected Paths

  • {{glob例: docs/src/, tests/, src/agent_taskstate.py}}

Local Commands

# Python
ruff check . && black --check . && mypy src/ && pytest tests/ -v

# Fallback
python -m pytest tests/ -v --cov=src

Deliverables

  • PR: タイトル/要約/影響/ロールバック
    • 本文へ Intent: INT-xxx と ## EVALUATION アンカーを明記
  • Artifacts: 変更パッチ、テスト、必要ならREADME/CHANGELOG差分

Plan

Steps

  1. 現状把握（対象ファイル列挙、既存テストとI/O確認）
  2. テストを先に記述
  3. 最小限の実装
  4. テスト実行→通過確認
  5. リファクタリング
  6. ドキュメント更新（必要なら）

Patch

Provide a unified diff. Include full paths. New files must be complete.

Tests

Outline

  • Unit:
    • {{case-1: 入力→出力の最小例}}
    • {{case-2: エッジ/エラー例}}
  • Integration:
    • {{代表シナリオ1つ}}

Commands

Run gates

pytest tests/ -v
ruff check src/ tests/
black --check src/ tests/
mypy src/

Notes

Rationale

  • {{設計判断を1～2行}}

Risks

  • {{既知の制約/互換性リスク}}

Follow-ups

  • {{後続タスクあれば}}

Template Usage

このテンプレートをコピーして TASK.<slug>-MM-DD-YYYY.md として保存：

# 例
TASK.task-create-test-03-07-2025.md
TASK.state-patch-conflict-03-07-2025.md