agentleFS
mae616mae616/ai-template/.claude/skills/experience-plan/SKILL.md

experience-plan

Skill9 starsChanged 3 months agoMITView on GitHub

機能・画面の実装着手前に「状態×見た目×周辺」を列挙する体験網羅チェックリスト。宣言外の実装を防ぐ関所として task-run/auto-task 等から使う。

The file

Files
SKILL.md

Experience Plan Skill

発火条件

  • UI/画面/機能の実装着手前(task-run の実装ステップ、UI変更を伴うタスク全般)に適用する。

思想(判断ルール)

  • 網羅の視点はチェックリストが供給する(モデル性能に依存させない)。暴走は「宣言=契約」で防ぐ。
  • 着手前に以下を列挙し、各項目へ「やる / やらない / 後続タスク化」を宣言してから実装する。宣言外の実装は禁止。
  • 宣言リストは人間のGO(またはIssue詳細化時の固定)を通す。

チェックリスト(着手前に列挙)

  • 全状態の見た目: 通常/遷移中/空/エラー/終了
  • モーション: 何が・いつ・なぜ動くか
  • 周辺の世界観整合: 背景・枠・境界で辻褄が合うか(例: 容器の外に中身がはみ出さない)
  • 文言: SSOT(copy.json等)参照か、直書きしていないか
  • 進行フィードバック: スコア・カウンタ等の反映

よくある落とし穴

  • チェックリストを飛ばして「動くもの」だけ作り、空/エラー状態が未実装のまま残る
  • 宣言していない追加実装(気づいた改善)をその場で実装してしまう(→後続タスク提案に留める)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.