<CRITICAL_INSTRUCTION>

BACKLOG WORKFLOW INSTRUCTIONS

This project uses Backlog.md MCP for all task and project management activities.

CRITICAL GUIDANCE

• If your client supports MCP resources, read backlog://workflow/overview to understand when and how to use Backlog for this project.

• If your client only supports tools or the above request fails, call backlog.get_workflow_overview() tool to load the tool-oriented overview (it lists the matching guide tools).

• First time working here? Read the overview resource IMMEDIATELY to learn the workflow

• Already familiar? You should have the overview cached ("## Backlog.md Overview (MCP)")

• When to read it: BEFORE creating tasks, or when you're unsure whether to track work

These guides cover:

• Decision framework for when to create tasks
• Search-first workflow to avoid duplicates
• Links to detailed guides for task creation, execution, and completion
• MCP tools reference

You MUST read the overview resource to understand the complete workflow. The information is NOT summarized here.

</CRITICAL_INSTRUCTION>

When you're working on a task, you should assign it yourself: -a @codex

In addition to the rules above, please consider the following: At the end of every task implementation, try to take a moment to see if you can simplify it. When you are done implementing, you know much more about a task than when you started. At this point you can better judge retrospectively what can be the simplest architecture to solve the problem. If you can simplify the code, do it.

Commands

Development

• bun i - Install dependencies
• bun test - Run all tests
• bunx tsc --noEmit - Type-check code
• bun run check . - Run all Biome checks (format + lint)
• bun run build - Build the CLI tool
• bun run cli - Uses the CLI tool directly

Testing

• bun test - Run all tests
• bun test <filename> - Run specific test file

Configuration Management

• bun run cli config list - View all configuration values
• bun run cli config get <key> - Get a specific config value (e.g. defaultEditor)
• bun run cli config set <key> <value> - Set a config value with validation

Core Structure

• CLI Tool: Built with Bun and TypeScript as a global npm package (npm i -g backlog.md)
• Source Code: Located in /src directory with modular TypeScript structure
• Task Management: Uses markdown files in backlog/ directory structure
• Workflow: Git-integrated with task IDs referenced in commits and PRs

Code Standards

• Runtime: Bun with TypeScript 5
• Formatting: Biome with tab indentation and double quotes
• Linting: Biome recommended rules
• Testing: Bun's built-in test runner
• Pre-commit: Husky + lint-staged automatically runs Biome checks before commits

The pre-commit hook automatically runs biome check --write on staged files to ensure code quality. If linting errors are found, the commit will be blocked until fixed.

Git Workflow

• Branching: Use feature branches when working on tasks (e.g. tasks/task-123-feature-name)
• Committing: Use the following format: TASK-123 - Title of the task
• Github CLI: Use gh whenever possible for PRs and issues