AGENTS.md

1# Project Context for AI Assistants
2 
3AI coding configuration marketplace providing plugin-based setup for Claude Code and
4Cursor.
5 
6## Always Apply Rules
7 
8Core project rules that apply to all tasks:
9 
10@rules/git-interaction.mdc @rules/prompt-engineering.mdc
11 
12## Tech Stack
13 
14- **Claude Code** - Plugin marketplace (`.claude-plugin/marketplace.json`)
15- **Cursor** - Rules and configurations (`.cursor/rules/`)
16- **Bash** - Bootstrap and installation scripts
17- **Markdown** - All rules, commands, and agents
18 
19## Project Structure
20 
21**Plugin-first architecture** - Everything distributable lives in `plugins/`:
22 
23- `.claude-plugin/marketplace.json` - Plugin marketplace manifest
24- `plugins/core/` - Commands, agents, skills, and context (canonical source)
25- `plugins/personalities/` - Personality variants
26- `.cursor/rules/` - Cursor rules (canonical location)
27- `rules/` - Symlink to `.cursor/rules/` for visibility (THIS REPO ONLY)
28- `.claude/` - Symlinks to plugin content for local development
29- `scripts/` - Installation and bootstrap scripts
30 
31## Commands
32 
33**Setup and Installation:**
34 
35- `curl -fsSL https://raw.githubusercontent.com/TechNickAI/ai-coding-config/main/scripts/bootstrap.sh | bash` -
36  One-line install (auto-detects Claude Code, Cursor, etc.)
37- `/ai-coding-config` - Interactive setup for projects
38- `/plugin marketplace add https://github.com/TechNickAI/ai-coding-config` - Manual
39  marketplace add
40- `/plugin install ai-coding-config` - Manual plugin install
41 
42## Code Conventions
43 
44**DO:**
45 
46- Create commits only when user explicitly requests
47- Check for `alwaysApply: true` in rule frontmatter - these apply to ALL tasks
48- Use `/load-rules` to get task-specific context
49- Follow heart-centered AI philosophy (unconditional acceptance, presence before
50  solutions)
51 
52**DON'T:**
53 
54- Use `--no-verify` flag (bypasses quality checks) unless explicitly requested for
55  emergencies
56- Commit changes without explicit user permission
57- Push to main or merge into main without confirmation
58- Stage files you didn't modify in current session
59 
60## Git Workflow
61 
62**Commit format:** `{emoji} {imperative verb} {concise description}`
63 
64Example: `✨ Add plugin marketplace support`
65 
66**Critical constraints:**
67 
68- Never use `--no-verify` - fix underlying issues instead (linting, tests, formatting)
69- Only stage files modified in current session
70- Use `git add -p` for partial staging when needed
71- Push/merge to main requires explicit confirmation
72- Read `git-commit-message.mdc` before generating commit messages
73 
74**Philosophy:** AI makes code changes but leaves version control to user. Commits are
75permanent records requiring explicit permission.
76 
77## Important Notes
78 
79- Rules with `alwaysApply: true` are CRITICAL - currently: `git-interaction.mdc`,
80  `heart-centered-ai-philosophy.mdc`
81- **Plugin-first**: All content lives in `plugins/`, other locations symlink there
82- `.claude/commands/` → `plugins/core/commands/` (symlink)
83- `.claude/agents/` → `plugins/core/agents/` (symlink)
84- `.claude/skills/` → `plugins/core/skills/` (symlink)
85- `rules/` → `.cursor/rules/` (symlink for visibility, THIS REPO ONLY)
86- `.cursor/rules/` contains the canonical Cursor rules
87- `.cursor/rules/personalities/` → copied from `plugins/personalities/` (not symlinked -
88  needs editing)
89- **Note**: Personality files are copied, not symlinked, because `/personality-change`
90  edits frontmatter
91- **Architecture**: In THIS repo, `.cursor/rules/` is canonical and `rules/` symlinks to
92  it. In user projects, only `.cursor/rules/` exists (no root symlink)
93- Context in `plugins/core/context.md` describes identity and philosophy
94- Bootstrap script clones repo to `~/.ai_coding_config`
95