Skip to content

AGENTS.md

Latest commit

 

History

History
94 lines (69 loc) · 3.59 KB

AGENTS.md

File metadata and controls

94 lines (69 loc) · 3.59 KB

Project Context for AI Assistants

AI coding configuration marketplace providing plugin-based setup for Claude Code and Cursor.

Always Apply Rules

Core project rules that apply to all tasks:

@rules/git-interaction.mdc @rules/prompt-engineering.mdc

Tech Stack

  • Claude Code - Plugin marketplace (.claude-plugin/marketplace.json)
  • Cursor - Rules and configurations (.cursor/rules/)
  • Bash - Bootstrap and installation scripts
  • Markdown - All rules, commands, and agents

Project Structure

Plugin-first architecture - Everything distributable lives in plugins/:

  • .claude-plugin/marketplace.json - Plugin marketplace manifest
  • plugins/core/ - Commands, agents, skills, and context (canonical source)
  • plugins/personalities/ - Personality variants
  • .cursor/rules/ - Cursor rules (canonical location)
  • rules/ - Symlink to .cursor/rules/ for visibility (THIS REPO ONLY)
  • .claude/ - Symlinks to plugin content for local development
  • scripts/ - Installation and bootstrap scripts

Commands

Setup and Installation:

  • curl -fsSL https://raw.githubusercontent.com/TechNickAI/ai-coding-config/main/scripts/bootstrap.sh | bash - One-line install (auto-detects Claude Code, Cursor, etc.)
  • /ai-coding-config - Interactive setup for projects
  • /plugin marketplace add https://github.com/TechNickAI/ai-coding-config - Manual marketplace add
  • /plugin install ai-coding-config - Manual plugin install

Code Conventions

DO:

  • Create commits only when user explicitly requests
  • Check for alwaysApply: true in rule frontmatter - these apply to ALL tasks
  • Use /load-rules to get task-specific context
  • Follow heart-centered AI philosophy (unconditional acceptance, presence before solutions)

DON'T:

  • Use --no-verify flag (bypasses quality checks) unless explicitly requested for emergencies
  • Commit changes without explicit user permission
  • Push to main or merge into main without confirmation
  • Stage files you didn't modify in current session

Git Workflow

Commit format: {emoji} {imperative verb} {concise description}

Example: ✨ Add plugin marketplace support

Critical constraints:

  • Never use --no-verify - fix underlying issues instead (linting, tests, formatting)
  • Only stage files modified in current session
  • Use git add -p for partial staging when needed
  • Push/merge to main requires explicit confirmation
  • Read git-commit-message.mdc before generating commit messages

Philosophy: AI makes code changes but leaves version control to user. Commits are permanent records requiring explicit permission.

Important Notes

  • Rules with alwaysApply: true are CRITICAL - currently: git-interaction.mdc, heart-centered-ai-philosophy.mdc
  • Plugin-first: All content lives in plugins/, other locations symlink there
  • .claude/commands/ → plugins/core/commands/ (symlink)
  • .claude/agents/ → plugins/core/agents/ (symlink)
  • .claude/skills/ → plugins/core/skills/ (symlink)
  • rules/ → .cursor/rules/ (symlink for visibility, THIS REPO ONLY)
  • .cursor/rules/ contains the canonical Cursor rules
  • .cursor/rules/personalities/ → copied from plugins/personalities/ (not symlinked - needs editing)
  • Note: Personality files are copied, not symlinked, because /personality-change edits frontmatter
  • Architecture: In THIS repo, .cursor/rules/ is canonical and rules/ symlinks to it. In user projects, only .cursor/rules/ exists (no root symlink)
  • Context in plugins/core/context.md describes identity and philosophy
  • Bootstrap script clones repo to ~/.ai_coding_config