CLAUDE.md

1# CLAUDE.md — Contribution Rules
2 
3This file defines the rules for maintaining and updating this repository.
4Follow these guidelines in every session without needing to be reminded.
5 
6---
7 
8## Repository Purpose
9 
10A centralized map of references for configuring AI coding assistants.
11Covers: skills, instructions, prompts, agents, rules, SDD tools and AI coding assistants.
12 
13**This is a map — not a catalog.**
14We point to repos and resources, we do not host skills or prompts directly.
15Only add resources that are specifically about configuring AI coding assistants.
16Do NOT add: AI frameworks, ML libraries, models, papers or general AI tools.
17 
18---
19 
20## Tags
21 
22Only add a tag when official support is **confirmed**. Do not guess.
23 
24**Always use image badges from `BADGES.md` — never plain text tags.**
25 
26### Assistant Tags
27| Tag | Assistant |
28|-----|-----------|
29| `claude` | [Claude Code](https://claude.ai/code) — Anthropic |
30| `copilot` | [GitHub Copilot](https://github.com/features/copilot) — GitHub |
31| `cursor` | [Cursor](https://www.cursor.com/) |
32| `gemini` | [Gemini CLI](https://github.com/google-gemini/gemini-cli) — Google |
33| `codex` | [Codex CLI](https://github.com/openai/codex) — OpenAI |
34| `windsurf` | [Windsurf](https://windsurf.com/) — Codeium |
35| `opencode` | [OpenCode](https://opencode.ai/) |
36 
37### Pricing Tags
38| Tag | Meaning |
39|-----|---------|
40| `free` | Has a free tier |
41| `paid` | Paid only |
42| `open source` | Source code is publicly available and freely modifiable |
43 
44---
45 
46## Sections
47 
48| Section | What belongs here |
49|---------|------------------|
50| Skills | SKILL.md repos and skill collections |
51| Instructions & Rules | `.cursorrules`, `copilot-instructions.md`, rule files |
52| Agents | Agent `.md` files, agent collections |
53| System Prompts | Reverse-engineered or reference system prompts |
54| Prompts & Templates | Prompt engineering resources and templates |
55| Tools | SDD tools and skill/config management tools |
56| AI Coding Assistants | The assistants themselves — not configs |
57| Content | Videos, posts and talks about the topic |
58 
59---
60 
61## Adding a Resource
62 
63Each entry must follow this format:
64 
65```markdown
66- **[owner/repo](https://github.com/owner/repo)** `tag1` `tag2`  
67  > One-line description of what it is and why it's relevant
68```
69 
70Rules:
71- Description must be in English
72- Keep descriptions short — one line only
73- Only add tags you are certain about
74- Place in the correct section
75- For paid tools, always add `free` or `paid` tag
76 
77---
78 
79## Content Section
80 
81The Content section has two subsections:
82 
83- **CodandoTV** — videos from the CodandoTV YouTube channel
84- **Community** — videos, posts or talks from anyone in the community
85 
86Format for videos:
87```markdown
88- **[Video Title](https://youtube.com/...)**
89```
90 
91---
92 
93## Bilingual Files
94 
95This repo has English and Portuguese (PT-BR) versions of key files:
96 
97| English | Portuguese |
98|---------|-----------|
99| `README.md` | `README.pt-br.md` |
100| `CONTRIBUTING.md` | `CONTRIBUTING.pt-br.md` |
101 
102**Rule: whenever you update the English version, you MUST update the PT-BR version in the same session.**
103Never leave the two versions out of sync.
104 
105---
106 
107## What NOT to add
108 
109- AI frameworks (LangChain, LlamaIndex, etc.)
110- ML models or model repos
111- On-device AI / edge AI libraries
112- General awesome-lists not related to coding assistant configuration
113- Tools without clear relation to AI coding assistant configuration
114