Skip to content

Conversation

@unagi
Copy link
Owner

@unagi unagi commented Jan 1, 2026

Summary

プロジェクトドキュメントの包括的な再構成により、すべてのステークホルダーに最適な情報提供を実現しました。

Changes

新規作成

  • DEVELOPMENT.md: 開発者向けガイド(セットアップ、開発タスク、コーディング規約)

変更

  • README.md: エンドユーザー向けガイドを統合
    • インストール手順(Claude.ai/Codex)
    • よくある質問
    • トラブルシューティング
    • 開発者 → DEVELOPMENT.md
    • AIエージェント → AGENTS.md

削除

  • skill/README.md: Agent Skills仕様違反のため削除
    • 仕様ではskill/配下はSKILL.md + オプショナルなscripts/, references/, assets/のみ許可
    • skill/配下はLLM経由でのみアクセスされる
    • エンドユーザー向け情報はプロジェクトルートのREADME.mdに統合
  • docs/development/layout_adjustment_history.md: 陳腐化した開発履歴
  • docs/development/font_selection_rationale.md: 陳腐化した開発履歴

維持

  • AGENTS.md: AIエージェント向けに最適化済み(変更不要)
  • CLAUDE.md: Agent Skills技術仕様(変更不要)

Motivation

問題点

  • README.md と SKILL.md で情報が不整合
  • skill/README.md がAgent Skills仕様に違反(https://agentskills.io/specification)
  • エンドユーザー向けインストール手順が不足
  • 人間開発者向けガイドが不在
  • 陳腐化した開発履歴が残存
  • 重複的なリンクセクション

解決策

  • Agent Skills仕様準拠(skill/配下はSKILL.md + scripts/references/assetsのみ)
  • エンドユーザー向け情報をプロジェクトルートのREADME.mdに集約
  • 開発者向けガイドをDEVELOPMENT.mdとして分離

Impact

  • エンドユーザー: インストール手順が明確化(Claude.ai/Codex対応)
  • 開発者: セットアップから品質基準まで一元化
  • AIエージェント: 技術仕様に集中(AGENTS.md)
  • Agent Skills仕様準拠により将来的な問題を回避

🤖 Generated with Claude Code

@codecov
Copy link

codecov bot commented Jan 1, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
⚠️ Please upload report for BASE (main@e31c433). Learn more about missing BASE report.
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main      #30   +/-   ##
=======================================
  Coverage        ?   90.96%           
=======================================
  Files           ?       22           
  Lines           ?     1936           
  Branches        ?        0           
=======================================
  Hits            ?     1761           
  Misses          ?      175           
  Partials        ?        0           
Flag Coverage Δ
unittests 90.96% <ø> (?)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

- Compact README.md with inline end-user guide
- Add DEVELOPMENT.md for human developers
- Delete skill/README.md (violates Agent Skills spec)
- Delete obsolete development history files
- Maintain AGENTS.md for AI agents (no changes needed)

Changes:
- README.md now includes installation guide for Claude.ai/Codex users
- skill/ directory follows Agent Skills specification (SKILL.md only)
- Clear entry points for all stakeholders:
  - End users: README.md (with installation/FAQ)
  - Developers: DEVELOPMENT.md
  - AI agents: AGENTS.md

Fixes issue where skill/README.md violated agentskills.io specification
which states skill directory should only contain SKILL.md + optional
scripts/references/assets directories.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
@unagi unagi force-pushed the docs/restructure-documentation branch from eb8f823 to 477dfb3 Compare January 1, 2026 02:50
@sonarqubecloud
Copy link

sonarqubecloud bot commented Jan 1, 2026

@unagi unagi merged commit acdd4aa into main Jan 1, 2026
4 checks passed
@unagi unagi deleted the docs/restructure-documentation branch January 1, 2026 02:51
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.

2 participants