| Dimension | Shared | Only in A | Only in B | Overlap |
|---|---|---|---|---|
| Sections | 0 | 14 | 17 | 0% |
| Commands | 0 | 3 | 0 | 0% |
| Section tags | 2 | 5 | 0 | 29% |
What each file covers
Sections
0 shared · 14 only in A · 17 only in B- − Development Guidelines
- − Technology Stack
- − When Source Code is Added
- − Always verify package.json exists first
- − Install dependencies with appropriate timeout
- − Build with extended timeout for AI projects
- − Run tests with adequate time
- − Build with reasonable timeout for most projects
- − AI Integration Best Practices
- − Preferred AI Dependencies
- − Code Organization
- − Error Handling Pattern
- − File Structure Standards
- − Development Workflow
- + AI Agents Configuration
- + Overview
- + Configured AI Agents
- + Claude AI
- + GitHub Copilot
- + Windsurf AI
- + Gemini CLI
- + OpenCode
- + Google Antigravity
- + Agent Coordination
- + Shared Principles
- + Repository Structure Awareness
- + Usage Guidelines
- + For Developers
- + For AI Agents
- + Adding New Agents
- + Notes
Commands
0 shared · 3 only in A · 0 only in B- − npm install
- − npm run build
- − npm test
Section tags
2 shared · 5 only in A · 0 only in B- − setup
- − build
- − test
- − code-style
- − dependencies
- architecture
- agent-behaviour
Line diff
HerringtonDarkholme/megarepo · .clinerules/02-development.md
@@ −1 @@
1# Development Guidelines
2
3## Technology Stack
4This repository is pre-configured for **Node.js/Next.js development** with AI integrations.
5
6### When Source Code is Added
7Follow these patterns based on existing repository guidelines:
8
9```bash
10# Always verify package.json exists first
11test -f package.json && echo "Node.js project detected" || echo "No package.json found"
12
13# Install dependencies with appropriate timeout
14npm install # Allow 10+ minutes for completion
15
16# Build with extended timeout for AI projects
17npm run build # Allow 60+ minutes - AI projects can have complex builds
18
19# Run tests with adequate time
20npm test # Allow 30+ minutes for comprehensive test suites
21```
22# Build with reasonable timeout for most projects
23npm run build # Allow 15-30 minutes for most Node.js/Next.js builds with AI integrations
24
25# Run tests with adequate time
26npm test # Allow 30+ minutes for comprehensive test suites
27## AI Integration Best Practices
28
29### Preferred AI Dependencies
30When adding AI functionality, use these established packages:
31- `openai` - Official OpenAI API client
32- `@langchain/core` - LangChain framework for AI workflows
33- `@vercel/ai` - Vercel AI SDK for streaming and UI integration
34- `@huggingface/inference` - Hugging Face API client
35- `@anthropic-ai/sdk` - Anthropic Claude API client
36
37### Code Organization
38- Place AI client configurations in `src/lib/` directory
39- Create reusable AI components in `src/components/ai/`
40- Implement API routes for AI services in `src/app/api/` (Next.js App Router)
41- Define TypeScript types for AI responses in `src/types/`
42
43### Error Handling Pattern
44```javascript
45// Implement comprehensive error handling for AI services
46try {
47 const response = await aiClient.chat.completions.create({
48 model: "gpt-4",
49 messages: [{ role: "user", content: prompt }]
50 });
51 return response.choices[0].message.content;
52} catch (error) {
53 if (error.code === 'rate_limit_exceeded') {
54 throw new AIRateLimitError('Rate limit exceeded, please try again later');
55 }
56 if (error.code === 'insufficient_quota') {
57 throw new AIQuotaError('API quota exceeded');
58 }
59 throw new AIServiceError(`AI service failed: ${error.message}`);
60}
61```
62
63## File Structure Standards
64Follow the established minimal structure and expand thoughtfully:
65
66```
67.
68├── .clinerules/ # Cline AI rules (this directory)
69├── .github/ # GitHub workflows and Copilot instructions
70├── .kiro/steering/ # Kiro AI steering files
71├── .cursorrules # Cursor AI development rules
72├── CLAUDE.md # Claude AI specific configuration
73├── GEMINI.md # Gemini CLI configuration
74├── AGENT.md # Universal AI agent instructions
75├── package.json # Dependencies and scripts (when added)
76├── src/ # Source code (when added)
77│ ├── lib/ # AI clients and utilities
78│ ├── components/ # React components including AI components
79│ ├── app/ # Next.js App Router (pages and API routes)
80│ └── types/ # TypeScript definitions
81└── public/ # Static assets
82```
83
84## Development Workflow
851. **Before Changes**: Check repository state and existing patterns
862. **During Development**: Follow TypeScript best practices and AI patterns
873. **Testing**: Include AI service mocks and error scenario testing
884. **Documentation**: Update relevant AI configuration files as needed
HerringtonDarkholme/megarepo · AGENTS.md
@@ +1 @@
1# AI Agents Configuration
2
3## Overview
4
5This repository includes configuration and instruction files for various AI agents to ensure consistent and effective collaboration in AI development projects. Each agent has specific instructions tailored to their capabilities and use cases within the megarepo ecosystem.
6
7## Configured AI Agents
8
9### Claude AI
10- **Configuration File**: `CLAUDE.md`
11- **Purpose**: Comprehensive AI development assistance, code generation, and project guidance
12- **Capabilities**:
13 - Code review and development
14 - AI-specific architectural guidance
15 - Documentation and testing strategies
16 - Environment setup and configuration
17
18### GitHub Copilot
19- **Configuration File**: `.github/copilot-instructions.md`
20- **Purpose**: IDE-integrated code completion and development assistance
21- **Capabilities**:
22 - Real-time code suggestions
23 - Repository navigation guidance
24 - Build and test workflow instructions
25 - Node.js/Next.js development patterns
26
27### Windsurf AI
28- **Configuration Files**: `.windsurf/rules/` directory with multiple rule files
29- **Purpose**: Intelligent code assistance with contextual rule activation
30- **Capabilities**:
31 - Context-aware rule activation (Always On, Manual, Model Decision, Glob patterns)
32 - AI development best practices and security guidelines
33 - TypeScript/JavaScript specific patterns and optimizations
34 - Testing strategies for AI components and integrations
35 - Documentation standards for AI projects
36
37### Gemini CLI
38- **Configuration File**: `GEMINI.md`
39- **Purpose**: Google's AI-powered command-line interface for interactive development
40- **Capabilities**:
41 - Interactive AI-assisted development sessions
42 - Context-aware code generation and editing
43 - File-based project memory and configuration
44 - Extensible tool system with MCP server support
45 - Project-specific settings and sandboxing options
46
47### OpenCode
48- **Configuration Files**: `opencode.json`, `AGENTS.md` (also supports `CLAUDE.md` as fallback)
49- **Purpose**: Modern AI coding assistant with TUI and web interfaces
50- **Capabilities**:
51 - Terminal-based UI (TUI) and web-based interfaces
52 - Multi-provider model support (Anthropic, OpenAI, etc.)
53 - Custom instructions via AGENTS.md files
54 - Extensible configuration with JSON schema support
55 - Project-specific and global configuration merging
56 - Remote organizational config support
57 - Compatible with Claude Code file conventions
58
59### Google Antigravity
60- **Configuration Files**: `.agent/rules/` and `.agent/skills/` directories
61- **Purpose**: Google's AI-powered development assistant with advanced rule-based activation and reusable skills
62- **Reference**: https://antigravity.google/docs/skills
63- **Capabilities**:
64 - Context-aware rule activation (Always On, Manual, Model Decision, Glob patterns)
65 - Reusable skills for AI development tasks (integration, prompt engineering, evaluation, code review, security)
66 - Workspace-level rules for consistent AI assistance
67 - AI development best practices and security guidelines
68 - File-type specific guidance via glob patterns
69 - Manual activation rules for specialized features
70 - Model-driven context-aware assistance
71
72## Agent Coordination
73
74### Shared Principles
75- **Minimal Changes**: All agents follow surgical, minimal modification approaches
76- **AI-First Design**: Configurations prioritize AI development workflows
77- **Environment Safety**: No API keys or secrets committed to repository
78- **Consistency**: Maintain uniform coding standards and documentation patterns
79
80### Repository Structure Awareness
81All agents are configured to understand:
82- Current minimal state of the repository
83- Node.js/Next.js target architecture
84- MIT license requirements
85- Pre-configured .gitignore patterns
86
87## Usage Guidelines
88
89### For Developers
901. **Review agent-specific files** before engaging with each AI assistant
912. **Follow established patterns** when working with any configured agent
923. **Maintain consistency** across different AI interactions
934. **Update configurations** as the repository evolves
94
95### For AI Agents
96- Always reference the appropriate configuration file for context
97- Coordinate with other agent configurations to maintain consistency
98- Respect the minimal, focused approach established in this repository
99- Update this overview when new agents are added
100
101## Adding New Agents
102
103When adding new AI agents to this repository:
104
1051. **Create agent-specific configuration file** following the established pattern
1062. **Update this AGENTS.md file** to include the new agent
1073. **Ensure compatibility** with existing agent configurations
1084. **Test coordination** between multiple agents if applicable
1095. **Document any special requirements** or limitations
110
111## Notes
112
113- This file serves as a central index for all AI agent configurations
114- Individual agent files contain detailed, agent-specific instructions
115- The repository is designed to evolve from its current minimal state
116- Always refer to `.github/copilot-instructions.md` for workflow details
117- Maintain the minimal, focused approach that characterizes this repository template
@@ −1 +1 @@
1−# Development Guidelines
1+# AI Agents Configuration
22
3−## Technology Stack
4−This repository is pre-configured for **Node.js/Next.js development** with AI integrations.
3+## Overview
54
6−### When Source Code is Added
7−Follow these patterns based on existing repository guidelines:
5+This repository includes configuration and instruction files for various AI agents to ensure consistent and effective collaboration in AI development projects. Each agent has specific instructions tailored to their capabilities and use cases within the megarepo ecosystem.
86
9−```bash
10−# Always verify package.json exists first
11−test -f package.json && echo "Node.js project detected" || echo "No package.json found"
7+## Configured AI Agents
128
13−# Install dependencies with appropriate timeout
14−npm install # Allow 10+ minutes for completion
9+### Claude AI
10+- **Configuration File**: `CLAUDE.md`
11+- **Purpose**: Comprehensive AI development assistance, code generation, and project guidance
12+- **Capabilities**:
13+ - Code review and development
14+ - AI-specific architectural guidance
15+ - Documentation and testing strategies
16+ - Environment setup and configuration
1517
16−# Build with extended timeout for AI projects
17−npm run build # Allow 60+ minutes - AI projects can have complex builds
18+### GitHub Copilot
19+- **Configuration File**: `.github/copilot-instructions.md`
20+- **Purpose**: IDE-integrated code completion and development assistance
21+- **Capabilities**:
22+ - Real-time code suggestions
23+ - Repository navigation guidance
24+ - Build and test workflow instructions
25+ - Node.js/Next.js development patterns
1826
19−# Run tests with adequate time
20−npm test # Allow 30+ minutes for comprehensive test suites
21−```
22−# Build with reasonable timeout for most projects
23−npm run build # Allow 15-30 minutes for most Node.js/Next.js builds with AI integrations
27+### Windsurf AI
28+- **Configuration Files**: `.windsurf/rules/` directory with multiple rule files
29+- **Purpose**: Intelligent code assistance with contextual rule activation
30+- **Capabilities**:
31+ - Context-aware rule activation (Always On, Manual, Model Decision, Glob patterns)
32+ - AI development best practices and security guidelines
33+ - TypeScript/JavaScript specific patterns and optimizations
34+ - Testing strategies for AI components and integrations
35+ - Documentation standards for AI projects
2436
25−# Run tests with adequate time
26−npm test # Allow 30+ minutes for comprehensive test suites
27−## AI Integration Best Practices
37+### Gemini CLI
38+- **Configuration File**: `GEMINI.md`
39+- **Purpose**: Google's AI-powered command-line interface for interactive development
40+- **Capabilities**:
41+ - Interactive AI-assisted development sessions
42+ - Context-aware code generation and editing
43+ - File-based project memory and configuration
44+ - Extensible tool system with MCP server support
45+ - Project-specific settings and sandboxing options
2846
29−### Preferred AI Dependencies
30−When adding AI functionality, use these established packages:
31−- `openai` - Official OpenAI API client
32−- `@langchain/core` - LangChain framework for AI workflows
33−- `@vercel/ai` - Vercel AI SDK for streaming and UI integration
34−- `@huggingface/inference` - Hugging Face API client
35−- `@anthropic-ai/sdk` - Anthropic Claude API client
47+### OpenCode
48+- **Configuration Files**: `opencode.json`, `AGENTS.md` (also supports `CLAUDE.md` as fallback)
49+- **Purpose**: Modern AI coding assistant with TUI and web interfaces
50+- **Capabilities**:
51+ - Terminal-based UI (TUI) and web-based interfaces
52+ - Multi-provider model support (Anthropic, OpenAI, etc.)
53+ - Custom instructions via AGENTS.md files
54+ - Extensible configuration with JSON schema support
55+ - Project-specific and global configuration merging
56+ - Remote organizational config support
57+ - Compatible with Claude Code file conventions
3658
37−### Code Organization
38−- Place AI client configurations in `src/lib/` directory
39−- Create reusable AI components in `src/components/ai/`
40−- Implement API routes for AI services in `src/app/api/` (Next.js App Router)
41−- Define TypeScript types for AI responses in `src/types/`
59+### Google Antigravity
60+- **Configuration Files**: `.agent/rules/` and `.agent/skills/` directories
61+- **Purpose**: Google's AI-powered development assistant with advanced rule-based activation and reusable skills
62+- **Reference**: https://antigravity.google/docs/skills
63+- **Capabilities**:
64+ - Context-aware rule activation (Always On, Manual, Model Decision, Glob patterns)
65+ - Reusable skills for AI development tasks (integration, prompt engineering, evaluation, code review, security)
66+ - Workspace-level rules for consistent AI assistance
67+ - AI development best practices and security guidelines
68+ - File-type specific guidance via glob patterns
69+ - Manual activation rules for specialized features
70+ - Model-driven context-aware assistance
4271
43−### Error Handling Pattern
44−```javascript
45−// Implement comprehensive error handling for AI services
46−try {
47− const response = await aiClient.chat.completions.create({
48− model: "gpt-4",
49− messages: [{ role: "user", content: prompt }]
50− });
51− return response.choices[0].message.content;
52−} catch (error) {
53− if (error.code === 'rate_limit_exceeded') {
54− throw new AIRateLimitError('Rate limit exceeded, please try again later');
55− }
56− if (error.code === 'insufficient_quota') {
57− throw new AIQuotaError('API quota exceeded');
58− }
59− throw new AIServiceError(`AI service failed: ${error.message}`);
60−}
61−```
72+## Agent Coordination
6273
63−## File Structure Standards
64−Follow the established minimal structure and expand thoughtfully:
74+### Shared Principles
75+- **Minimal Changes**: All agents follow surgical, minimal modification approaches
76+- **AI-First Design**: Configurations prioritize AI development workflows
77+- **Environment Safety**: No API keys or secrets committed to repository
78+- **Consistency**: Maintain uniform coding standards and documentation patterns
6579
66−```
67−.
68−├── .clinerules/ # Cline AI rules (this directory)
69−├── .github/ # GitHub workflows and Copilot instructions
70−├── .kiro/steering/ # Kiro AI steering files
71−├── .cursorrules # Cursor AI development rules
72−├── CLAUDE.md # Claude AI specific configuration
73−├── GEMINI.md # Gemini CLI configuration
74−├── AGENT.md # Universal AI agent instructions
75−├── package.json # Dependencies and scripts (when added)
76−├── src/ # Source code (when added)
77−│ ├── lib/ # AI clients and utilities
78−│ ├── components/ # React components including AI components
79−│ ├── app/ # Next.js App Router (pages and API routes)
80−│ └── types/ # TypeScript definitions
81−└── public/ # Static assets
82−```
80+### Repository Structure Awareness
81+All agents are configured to understand:
82+- Current minimal state of the repository
83+- Node.js/Next.js target architecture
84+- MIT license requirements
85+- Pre-configured .gitignore patterns
8386
84−## Development Workflow
85−1. **Before Changes**: Check repository state and existing patterns
86−2. **During Development**: Follow TypeScript best practices and AI patterns
87−3. **Testing**: Include AI service mocks and error scenario testing
88−4. **Documentation**: Update relevant AI configuration files as needed
87+## Usage Guidelines
88+
89+### For Developers
90+1. **Review agent-specific files** before engaging with each AI assistant
91+2. **Follow established patterns** when working with any configured agent
92+3. **Maintain consistency** across different AI interactions
93+4. **Update configurations** as the repository evolves
94+
95+### For AI Agents
96+- Always reference the appropriate configuration file for context
97+- Coordinate with other agent configurations to maintain consistency
98+- Respect the minimal, focused approach established in this repository
99+- Update this overview when new agents are added
100+
101+## Adding New Agents
102+
103+When adding new AI agents to this repository:
104+
105+1. **Create agent-specific configuration file** following the established pattern
106+2. **Update this AGENTS.md file** to include the new agent
107+3. **Ensure compatibility** with existing agent configurations
108+4. **Test coordination** between multiple agents if applicable
109+5. **Document any special requirements** or limitations
110+
111+## Notes
112+
113+- This file serves as a central index for all AI agent configurations
114+- Individual agent files contain detailed, agent-specific instructions
115+- The repository is designed to evolve from its current minimal state
116+- Always refer to `.github/copilot-instructions.md` for workflow details
117+- Maintain the minimal, focused approach that characterizes this repository template
