# Firstmate Coding Guidelines

Load before editing firstmate's shared, tracked material as defined by AGENTS.md...

- Repository: https://github.com/kunchenguid/firstmate (8480 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add kunchenguid/firstmate --skill firstmate-coding-guidelines -g -a claude-code -y`
Codex: `npx skills add kunchenguid/firstmate --skill firstmate-coding-guidelines -g -a codex -y`
Cursor: `npx skills add kunchenguid/firstmate --skill firstmate-coding-guidelines -g -a cursor -y`
Gemini CLI: `npx skills add kunchenguid/firstmate --skill firstmate-coding-guidelines -g -a gemini-cli -y`

## Description

Load before editing firstmate's shared, tracked material as defined by AGENTS.md section 1, whether working as firstmate directly or as a crewmate briefed on a firstmate-repo task.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# firstmate-coding-guidelines

Load this before changing firstmate's shared, tracked material, as defined by `AGENTS.md` section 1.
It exists because `AGENTS.md` grew from 585 to 958 lines between its last two restructures, entirely from conditional detail added inline instead of routed to its right home.
Applying the rules below on every change is what keeps that from happening again.

## Knowledge-placement decision tree

Before writing a new fact anywhere in this repo, ask where it belongs, in this order.

The rest: https://github.com/kunchenguid/firstmate/blob/HEAD/.agents/skills/firstmate-coding-guidelines/SKILL.md