# Contributing to KatanA Desktop

First off, thank you for considering contributing to KatanA Desktop!
It's people like you that make this tool better for everyone.

> **Note**: This file (`CONTRIBUTING.md`) is the canonical English version of the guide. For Japanese speakers, please see [`CONTRIBUTING.ja.md`](CONTRIBUTING.ja.md). Both documents must be kept in sync.

## What We're Looking For

KatanA is in its early stages, and we are actively shaping its future. We are especially looking for contributors who can help with:

### 1. Design & UX Feedback

We want KatanA to be not just fast, but beautiful and intuitive.

- Provide design mockups, wireframes, or CSS/styling suggestions.
- Give us feedback on user experience (UX) and how we can make the app more developer-friendly.

### 2. Product Direction & "Sounding Board"

Help us decide what goes in and what stays out.

- What features are essential for a modern Markdown workspace?
- What existing features should be removed or simplified?
- Join the discussions to help us prioritize our roadmap.

### 3. AI-Agent-Assisted Development

This project is built with an **AI-agent-first** methodology (primarily using Antigravity).

- We strongly welcome contributors who use AI coding agents to assist their development.
- Feel free to submit Pull Requests generated or assisted by AI agents! Just make sure to verify the implementation.

## How to Get Involved

### If you have an idea, question, or feedback

Join our **[GitHub Discussions](https://github.com/HiroyukiFuruno/KatanA/discussions)**. This is the best place to talk about product direction, suggest new features, or bounce ideas around.

### If you found a bug

Open a **[GitHub Issue](https://github.com/HiroyukiFuruno/KatanA/issues)**. Please provide as much detail as possible (macOS version, KatanA version, steps to reproduce).

### If you want to write code

1. Check the existing Issues and Discussions.
2. If you're using an AI agent (like Antigravity), direct it to the repository's `.agents/skills/` directory to learn our workflows before making changes.
3. Please read our **[Development Guide](docs/development-guide.md)** for local setup instructions and our **[Coding Rules](docs/coding-rules.md)**.
4. Submit a Pull Request.

## Sync Rule

When updating this guide, please ensure that both `CONTRIBUTING.md` and `CONTRIBUTING.ja.md` are updated simultaneously to match each other.

Thank you for helping us forge KatanA into a better tool!