Skip to content

Commit 173ad8b

Browse files
wishket-pjwJeremyDev87
authored andcommitted
feat: improve Cursor Agent integration structure (apply DRY principle)
- Improve structure for automatic Agent activation in Cursor - Add AGENTS.md: industry standard format for cross-platform compatibility - Add auto-agent.mdc: glob pattern-based Agent auto-activation - Simplify imports.mdc: reduce from 178 lines to 35 lines, core principles only - Update cursor.md adapter: document new integration structure - Apply Single Source of Truth principle: - All Agent definitions managed only in packages/rules/.ai-rules/ - AGENTS.md and .mdc files act as pointers only - Remove duplication to improve maintainability close #147
1 parent dda0e31 commit 173ad8b

4 files changed

Lines changed: 266 additions & 259 deletions

File tree

.cursor/rules/auto-agent.mdc

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
---
2+
description: codingbuddy Agent auto-activation based on file patterns
3+
globs:
4+
- "**/*.tsx"
5+
- "**/*.ts"
6+
- "**/*.go"
7+
- "**/*.py"
8+
- "**/*.java"
9+
- "**/*.rs"
10+
- "**/Dockerfile"
11+
- "**/*.yml"
12+
- "**/*.yaml"
13+
alwaysApply: false
14+
---
15+
16+
# codingbuddy Agent System
17+
18+
## Required: Mode Keyword Detection
19+
20+
When user message starts with `PLAN`, `ACT`, `EVAL` (or localized variants):
21+
22+
→ **Immediately** call `parse_mode` MCP tool
23+
24+
## File Context → Agent Mapping
25+
26+
| File Pattern | Recommended Agent | MCP Call |
27+
|--------------|-------------------|----------|
28+
| `*.tsx`, `*.ts` | frontend-developer | `get_agent_details("frontend-developer")` |
29+
| `*.go`, `*.py`, `*.java`, `*.rs` | backend-developer | `get_agent_details("backend-developer")` |
30+
| `Dockerfile`, `*.yml` | devops-engineer | `get_agent_details("devops-engineer")` |
31+
| `*.json` (agents/) | agent-architect | `get_agent_details("agent-architect")` |
32+
33+
## Specialist Auto-Recommendation
34+
35+
| Detected Topic | Recommended Specialist |
36+
|----------------|------------------------|
37+
| Security, auth, XSS, CSRF | security-specialist |
38+
| Accessibility, ARIA, a11y, WCAG | accessibility-specialist |
39+
| Performance, bundle, optimization | performance-specialist |
40+
| Testing, TDD, coverage | test-strategy-specialist |
41+
| Architecture, layers, dependencies | architecture-specialist |
42+
43+
→ Use `prepare_parallel_agents` for parallel reviews
44+
45+
## Reference
46+
47+
Agent definitions: `packages/rules/.ai-rules/agents/README.md`

.cursor/rules/imports.mdc

Lines changed: 19 additions & 161 deletions
Original file line numberDiff line numberDiff line change
@@ -1,177 +1,35 @@
11
---
2-
description: Common AI Rules Import - References shared rules from packages/rules/.ai-rules/
2+
description: codingbuddy common rules - applied to all conversations
33
globs:
44
alwaysApply: true
55
---
66

7-
# Common AI Rules Reference
7+
# codingbuddy Rules
88

9-
This project uses shared AI coding rules from `packages/rules/.ai-rules/` directory for consistency across all AI assistants (Cursor, Claude Code, Antigravity, Codex, Q, Kiro).
9+
## Workflow
1010

11-
## 📚 Core Workflow Rules
11+
- **PLAN** → **ACT** → **PLAN** (default flow)
12+
- **EVAL** only on explicit request
1213

13-
**Source**: [packages/rules/.ai-rules/rules/core.md](../../packages/rules/.ai-rules/rules/core.md)
14+
## Required Actions
1415

15-
### Work Modes
16+
When `PLAN`, `ACT`, `EVAL` keywords detected → **Immediately** call `parse_mode` MCP tool
1617

17-
You have three modes of operation:
18+
## Core Principles
1819

19-
1. **PLAN mode** - Define a plan without making changes
20-
2. **ACT mode** - Execute the plan and make changes
21-
3. **EVAL mode** - Analyze results and propose improvements
20+
- TDD: Red → Green → Refactor
21+
- Test coverage 90%+
22+
- TypeScript strict (no `any`)
23+
- Server Components first
2224

23-
**Mode Flow**:
24-
- Start in PLAN mode by default
25-
- Move to ACT when user types `ACT`
26-
- Return to PLAN after ACT completes (automatic)
27-
- Move to EVAL only when user explicitly types `EVAL`
25+
## Project Config
2826

29-
**Mode Indicators**:
30-
- Print `# Mode: PLAN` in plan mode
31-
- Print `# Mode: ACT` in act mode
32-
- Print `# Mode: EVAL` in eval mode
27+
Use `get_project_config` MCP tool to retrieve project-specific settings (language, tech stack, conventions).
3328

34-
### Agent System
29+
## Detailed Rules
3530

36-
**Auto-activated Agents**:
37-
- **Frontend Developer** (`packages/rules/.ai-rules/agents/frontend-developer.json`): PLAN/ACT modes
38-
- **Code Reviewer** (`packages/rules/.ai-rules/agents/code-reviewer.json`): EVAL mode
31+
All details in Single Source of Truth:
3932

40-
**Specialist Agents** (12 available):
41-
- Architecture, Test Strategy, Performance, Security
42-
- Accessibility, SEO, Design System, Documentation
43-
- Code Quality, DevOps Engineer
44-
45-
For complete workflow details, see [packages/rules/.ai-rules/rules/core.md](../../packages/rules/.ai-rules/rules/core.md)
46-
47-
---
48-
49-
## 🏗️ Project Setup
50-
51-
**Source**: [packages/rules/.ai-rules/rules/project.md](../../packages/rules/.ai-rules/rules/project.md)
52-
53-
### Tech Stack
54-
55-
프로젝트의 `package.json`을 참조하세요.
56-
57-
### Project Structure
58-
```
59-
src/
60-
├── app/ # Next.js App Router
61-
├── entities/ # Domain entities (business logic)
62-
├── features/ # Feature-specific UI components
63-
├── widgets/ # Composite widgets
64-
└── shared/ # Common modules
65-
```
66-
67-
### Development Rules
68-
- **Layer dependency**: app → widgets → features → entities → shared
69-
- **Pure/impure separation**: Separate files for pure and impure functions
70-
- **Server Components**: Default, Client Components only when necessary
71-
- **Test coverage**: 90%+ goal
72-
73-
For complete project setup, see [packages/rules/.ai-rules/rules/project.md](../../packages/rules/.ai-rules/rules/project.md)
74-
75-
---
76-
77-
## 🎯 Augmented Coding Principles
78-
79-
**Source**: [packages/rules/.ai-rules/rules/augmented-coding.md](../../packages/rules/.ai-rules/rules/augmented-coding.md)
80-
81-
### TDD Cycle (Strict Adherence)
82-
83-
Follow the **Red → Green → Refactor** cycle:
84-
85-
1. **Red**: Write a failing test that defines functionality
86-
2. **Green**: Implement minimum code needed to pass
87-
3. **Refactor**: Improve structure only after tests pass
88-
89-
### Core Principles
90-
- **TDD for core logic** (entities, shared/utils, shared/hooks)
91-
- **Test-after for UI** (features, widgets)
92-
- **SOLID principles** and code quality standards
93-
- **90%+ test coverage** goal
94-
- **No mocking** - test real behavior with actual implementations
95-
96-
### Code Quality Standards
97-
- TypeScript strict mode (no `any`)
98-
- DRY (Don't Repeat Yourself)
99-
- Keep methods small (10-20 lines max)
100-
- Minimize state, prefer pure functions
101-
- Tidy First: Separate structural vs behavioral changes
102-
103-
For complete augmented coding guide, see [packages/rules/.ai-rules/rules/augmented-coding.md](../../packages/rules/.ai-rules/rules/augmented-coding.md)
104-
105-
---
106-
107-
## 🤖 Specialist Agents
108-
109-
**Source**: [packages/rules/.ai-rules/agents/](../../packages/rules/.ai-rules/agents/)
110-
111-
All specialist agents are defined in `packages/rules/.ai-rules/agents/` directory:
112-
113-
| Agent | Expertise | Use Cases |
114-
|-------|-----------|-----------|
115-
| Frontend Developer | React/Next.js, TDD, design system | Component implementation, Server Actions |
116-
| Code Reviewer | Quality evaluation, architecture | Code review, production readiness |
117-
| Security Specialist | OAuth 2.0, JWT, XSS/CSRF | Authentication, security audit |
118-
| Accessibility Specialist | WCAG 2.1 AA, ARIA | A11y compliance, screen readers |
119-
| Performance Specialist | Bundle size, Core Web Vitals | Performance tuning, optimization |
120-
| +7 more specialists | Various domains | See agents README |
121-
122-
For complete agent documentation, see [packages/rules/.ai-rules/agents/README.md](../../packages/rules/.ai-rules/agents/README.md)
123-
124-
---
125-
126-
## 🔴 MANDATORY: Keyword Mode Detection
127-
128-
<CODINGBUDDY_CRITICAL_RULE>
129-
130-
**When user message starts with PLAN, ACT, or EVAL keyword (or localized: Korean 계획/실행/평가, Japanese 計画/実行/評価, Chinese 计划/执行/评估, Spanish PLANIFICAR/ACTUAR/EVALUAR):**
131-
132-
1. **IMMEDIATELY** call `parse_mode` MCP tool with the user's prompt
133-
2. Follow the returned `instructions` **EXACTLY**
134-
3. Apply the returned `rules` as context
135-
4. If `warnings` are present, inform the user
136-
137-
**This is MANDATORY, not optional.**
138-
139-
Failure to call `parse_mode` when these keywords are present will result in:
140-
- Missed critical checklists (Devil's Advocate Analysis, Impact Radius Analysis)
141-
- Incomplete evaluations
142-
- Quality issues not caught before deployment
143-
144-
**Red Flags** (STOP if you think these):
145-
| Thought | Reality |
146-
|---------|---------|
147-
| "I can handle EVAL myself" | NO. Call parse_mode FIRST. |
148-
| "The rules are similar anyway" | NO. Each mode has specific checklists. |
149-
| "I'll save a tool call" | NO. parse_mode MUST be called FIRST. |
150-
| "I already know what to do" | NO. Rules may have been updated. |
151-
152-
</CODINGBUDDY_CRITICAL_RULE>
153-
154-
Example: `PLAN design auth feature` → **즉시** parse_mode 호출 → PLAN 모드로 작업
155-
156-
---
157-
158-
## 💬 Communication
159-
160-
- **Always respond in Korean (한국어)**
161-
- User frequently modifies code directly, so **always read code and refresh information** instead of relying on memory
162-
- **Start by understanding current code state** for every question
163-
164-
---
165-
166-
## 📖 Full Documentation
167-
168-
For comprehensive guides:
169-
- **Core Rules**: [packages/rules/.ai-rules/rules/core.md](../../packages/rules/.ai-rules/rules/core.md)
170-
- **Project Setup**: [packages/rules/.ai-rules/rules/project.md](../../packages/rules/.ai-rules/rules/project.md)
171-
- **Augmented Coding**: [packages/rules/.ai-rules/rules/augmented-coding.md](../../packages/rules/.ai-rules/rules/augmented-coding.md)
172-
- **Agents System**: [packages/rules/.ai-rules/agents/README.md](../../packages/rules/.ai-rules/agents/README.md)
173-
- **Integration Guide**: [packages/rules/.ai-rules/adapters/cursor.md](../../packages/rules/.ai-rules/adapters/cursor.md)
174-
175-
---
176-
177-
**Note**: This file references common AI rules from `packages/rules/.ai-rules/` directory. All AI assistants (Cursor, Claude Code, Antigravity, etc.) share the same rules for consistency.
33+
- [`packages/rules/.ai-rules/rules/core.md`](../../packages/rules/.ai-rules/rules/core.md)
34+
- [`packages/rules/.ai-rules/rules/augmented-coding.md`](../../packages/rules/.ai-rules/rules/augmented-coding.md)
35+
- [`packages/rules/.ai-rules/agents/README.md`](../../packages/rules/.ai-rules/agents/README.md)

AGENTS.md

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
# AGENTS.md
2+
3+
This project uses [codingbuddy](https://www.npmjs.com/package/codingbuddy) MCP server to manage AI Agents.
4+
5+
## Quick Start
6+
7+
### For End Users (Your Project)
8+
9+
1. **Install MCP Server**
10+
11+
```json
12+
// Claude Code: .claude/settings.json
13+
{
14+
"mcpServers": {
15+
"codingbuddy": {
16+
"command": "npx",
17+
"args": ["-y", "codingbuddy"]
18+
}
19+
}
20+
}
21+
```
22+
23+
```json
24+
// Cursor: .cursor/mcp.json
25+
{
26+
"mcpServers": {
27+
"codingbuddy": {
28+
"command": "npx",
29+
"args": ["-y", "codingbuddy"]
30+
}
31+
}
32+
}
33+
```
34+
35+
2. **Use Mode Keywords**
36+
37+
```
38+
PLAN Design a login feature
39+
```
40+
41+
`parse_mode` tool is automatically called, loading appropriate Agent and rules.
42+
43+
### For Monorepo Contributors
44+
45+
Direct file references work within this repository:
46+
47+
- Workflow: `packages/rules/.ai-rules/rules/core.md`
48+
- Coding principles: `packages/rules/.ai-rules/rules/augmented-coding.md`
49+
- Agent list: `packages/rules/.ai-rules/agents/README.md`
50+
51+
## Workflow Modes
52+
53+
| Keyword | Mode | Description |
54+
|---------|------|-------------|
55+
| `PLAN` | Plan | Design and planning before implementation |
56+
| `ACT` | Act | Implement code following the plan |
57+
| `EVAL` | Eval | Code quality review and improvement |
58+
59+
Multi-language keywords supported:
60+
- 한국어: `계획`, `실행`, `평가`
61+
- 日本語: `計画`, `実行`, `評価`
62+
- 中文: `计划`, `执行`, `评估`
63+
- Español: `PLANIFICAR`, `ACTUAR`, `EVALUAR`
64+
65+
## MCP Tools
66+
67+
| Tool | Purpose |
68+
|------|---------|
69+
| `parse_mode` | Parse mode keywords, load Agent and rules |
70+
| `get_agent_details` | Get specific Agent details |
71+
| `get_project_config` | Get project configuration |
72+
| `recommend_skills` | Recommend skills based on prompt |
73+
| `search_rules` | Search across all rules |
74+
75+
## Reference
76+
77+
- **Rules**: [`packages/rules/.ai-rules/rules/`](packages/rules/.ai-rules/rules/)
78+
- **Agents**: [`packages/rules/.ai-rules/agents/`](packages/rules/.ai-rules/agents/)
79+
- **Skills**: [`packages/rules/.ai-rules/skills/`](packages/rules/.ai-rules/skills/)
80+
- **MCP API**: [`docs/api.md`](docs/api.md)

0 commit comments

Comments
 (0)