kora-journallisted

# Kora Journal — Continuous Improvement for Kora Skills > **Kora sub-skill — obey the [kora-v1 meta rules](../../SKILL.md) on every task:** **R0** ensure `.kora-agent/` docs+examples are cloned · **R1** read this sub-skill before writing code · **R2** Kora APIs only — no Spring/Micronaut/Quarkus, no invented annotations or config keys · **R3** journal any incorrect Kora usage. Add comments/Javadoc only if asked. **Location:** `~/.kora-journal/<project>/<module>/<YYYY-MM-DD>_slug.md` **Format:** Each entry is a **separate Markdown file** for easy management, export, and integration. --- ## ⚠️ READ FIRST — Purpose & Scope **Purpose:** Journal for recording **Kora Framework incorrect usage** discovered during development — when the agent used Kora incorrectly and realized it or the user pointed it out. **⚠️ SCOPE — Kora Incorrect Usage ONLY:** | ✅ Record in Journal | ❌ Do NOT Record | |----------------------|------------------| | Agent used wrong Kora annotation (self-realized or user-pointed) | Application business logic | | Agent hallucinated non-existent Kora API | Project-specific domain rules | | Agent misapplied Kora pattern (DI, AOP, config, etc.) | Temporary project workarounds | | Agent violated Kora best practices from skills | UI/UX preferences | | Skill documentation was unclear/wrong | Non-Kora framework issues | **Trigger:** When YOU (agent) realize OR USER points out that you used Kora Framework incorrectly. **Why:** Journal feeds skill improvements. Non