CLAUDE.md

Claude Code Instructions

For Claude Code. This file points to the centralized documentation in .agent/.

---

Documentation Location

All agent documentation is centralized in the .agent/ directory.

Start here: .agent/readme.md

---

Quick Reference

System Documentation

• Architecture — System overview, modules, patterns

Workflows

• /build — Build project
• /test — Run tests
• /backend_dependencies — Dependency updates
• /update-doc — Update documentation

Learning Resources

• Task History — Past implementation plans
• SOPs — Standard operating procedures

Skills

Skills are reusable instructions that an agent can load with the skill tool.

Current status:

• git-commit-formatter — Formats git commit messages to Conventional Commits when asked to commit or draft commit messages. See .agent/skills/git-commit-formatter/SKILL.md.

---

Common Commands

Build

./gradlew build                    # Build project

Test

./gradlew test                     # Run all tests

Lint

./gradlew ktlintCheck              # Check code style
./gradlew ktlintFormat             # Auto-fix formatting

---

Project Structure

kogmios/
├── .agent/                 # 📚 Agent documentation (READ THIS)
├── buildSrc/               # Version catalog/constants
├── src/                    # Kotlin source/tests
└── gradle/                 # Gradle wrapper

---

Creating Documentation

When completing features or resolving issues:

1. Implementation plans → Save to .agent/task/{domain}/
2. Resolved issues → Create SOP in .agent/SOPs/{category}/
3. New workflows → Add to .agent/workflows/

Run /update-doc workflow for guidance.