| Dimension | Shared | Only in A | Only in B | Overlap |
|---|---|---|---|---|
| Sections | 0 | 42 | 17 | 0% |
| Commands | 0 | 11 | 0 | 0% |
| Section tags | 2 | 9 | 0 | 18% |
What each file covers
Sections
0 shared · 42 only in A · 17 only in B- − Megarepo - AI Setup Repository
- − Repository Overview
- − Current Repository State
- − Working Effectively
- − Initial Repository Exploration
- − Always start by understanding the current repository state
- − When Source Code is Added
- − Check for package.json first
- − If package.json exists, install dependencies
- − NEVER CANCEL: npm install typically takes 2-5 minutes. Set timeout to 10+ minutes.
- − Common build commands (verify these exist in package.json first)
- − NEVER CANCEL: Build may take 5-45 minutes depending on project size. Set timeout to 60+ minutes.
- − Common test commands
- − NEVER CANCEL: Tests may take 5-15 minutes. Set timeout to 30+ minutes.
- − Common development server
- − Check for linting configuration
- − Run linting if configured
- − Run formatting if configured
- − Run type checking if TypeScript
- − Repository Structure Expectations
- − Validation Requirements
- − Before Making Changes
- − After Making Changes
- − Common Commands Reference
- − Repository Information
- − View current files
- − Check git status
- − View repository structure
- − When Package.json Exists
- − View available scripts
- − Install dependencies
- − TIMEOUT: 10+ minutes
- − Common development commands (check package.json first)
- − File Locations and Navigation
- − Current Key Files
- − Expected Important Locations (when populated)
- − AI Development Guidelines
- − Troubleshooting
- − Repository Appears Empty
- − Build Failures
- − Development Server Issues
- − Critical Reminders
- + 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 · 11 only in A · 0 only in B- − git status
- − npm install
- − npm run build
- − npm test
- − npm run dev
- − npm run lint
- − npm run format
- − npm run type-check
- − npm run start
- − npm run test
- − git branch -a
Section tags
2 shared · 9 only in A · 0 only in B- − setup
- − build
- − test
- − lint-format
- − types
- − git-pr
- − security
- − dependencies
- − do-not
- architecture
- agent-behaviour
Line diff
HerringtonDarkholme/megarepo · .github/copilot-instructions.md
@@ −1 @@
1# Megarepo - AI Setup Repository
2
3**ALWAYS follow these instructions first and only fallback to additional search and context gathering if the information here is incomplete or found to be in error.**
4
5## Repository Overview
6
7Megarepo is currently a minimal repository template designed for AI-related projects. The repository contains basic setup files and is configured for Node.js/Next.js development based on the .gitignore patterns.
8
9## Current Repository State
10
11**IMPORTANT**: This repository is currently in a minimal state with only basic setup files:
12- README.md (basic project description)
13- LICENSE (MIT license)
14- .gitignore (configured for Node.js/Next.js projects)
15
16**DO NOT attempt to build, test, or run code** - there is no source code or build system present yet.
17
18## Working Effectively
19
20### Initial Repository Exploration
21```bash
22# Always start by understanding the current repository state
23ls -la
24git status
25find . -type f -name "*.json" -o -name "*.js" -o -name "*.ts" -o -name "*.md"
26```
27
28### When Source Code is Added
29
30The repository is pre-configured for Node.js/Next.js development. When source code is added, follow these patterns:
31
32#### Node.js/Next.js Project Setup
33```bash
34# Check for package.json first
35ls package.json
36
37# If package.json exists, install dependencies
38npm install
39# NEVER CANCEL: npm install typically takes 2-5 minutes. Set timeout to 10+ minutes.
40
41# Common build commands (verify these exist in package.json first)
42npm run build
43# NEVER CANCEL: Build may take 5-45 minutes depending on project size. Set timeout to 60+ minutes.
44
45# Common test commands
46npm test
47# NEVER CANCEL: Tests may take 5-15 minutes. Set timeout to 30+ minutes.
48
49# Common development server
50npm run dev
51```
52
53#### Pre-commit Validation
54When source code exists, always run these before committing:
55```bash
56# Check for linting configuration
57ls .eslintrc* eslint.config.* .prettierrc*
58
59# Run linting if configured
60npm run lint
61
62# Run formatting if configured
63npm run format
64
65# Run type checking if TypeScript
66npm run type-check
67```
68
69## Repository Structure Expectations
70
71Based on the .gitignore configuration, expect the following when the repository is populated:
72
73```
74.
75├── README.md # Project documentation
76├── LICENSE # MIT license
77├── .gitignore # Node.js/Next.js ignore patterns
78├── package.json # Node.js dependencies and scripts
79├── package-lock.json # Dependency lockfile
80├── next.config.js # Next.js configuration (if Next.js)
81├── tsconfig.json # TypeScript configuration (if TypeScript)
82├── .eslintrc.* # ESLint configuration
83├── .prettierrc # Prettier configuration
84├── src/ # Source code directory
85│ ├── pages/ # Next.js pages (if Next.js)
86│ ├── components/ # React components
87│ └── utils/ # Utility functions
88├── public/ # Static assets
89├── .next/ # Next.js build output (ignored)
90├── build/ # Build output (ignored)
91└── node_modules/ # Dependencies (ignored)
92```
93
94## Validation Requirements
95
96### Before Making Changes
971. **Always check current repository state first**:
98 ```bash
99 git status
100 ls -la
101 cat package.json # Only if it exists
102 ```
103
1042. **Verify build system exists before attempting builds**:
105 ```bash
106 # Check for package.json before running npm commands
107 test -f package.json && echo "Node.js project detected" || echo "No package.json found"
108 ```
109
110### After Making Changes
1111. **When source code is present, always validate**:
112 ```bash
113 # Install dependencies if package.json exists
114 test -f package.json && npm install
115
116 # Build if build script exists
117 test -f package.json && npm run build
118
119 # Test if test script exists
120 test -f package.json && npm test
121
122 # Lint if lint script exists
123 test -f package.json && npm run lint
124 ```
125
1262. **Manual validation scenarios when application exists**:
127 - Start the development server and verify it loads
128 - Test basic functionality by navigating through the application
129 - Verify any API endpoints respond correctly
130 - Check console for errors
131
132## Common Commands Reference
133
134### Repository Information
135```bash
136# View current files
137ls -la
138
139# Check git status
140git status
141
142# View repository structure
143tree . -a -I 'node_modules|.git' # If tree is available (use -a to show hidden files)
144find . -type f -not -path "./.git/*" -not -path "./node_modules/*" | sort
145```
146
147### When Package.json Exists
148```bash
149# View available scripts
150cat package.json | grep -A 20 '"scripts"'
151
152# Install dependencies
153npm install
154# TIMEOUT: 10+ minutes
155
156# Common development commands (check package.json first)
157npm run dev # Development server
158npm run build # Production build
159npm run start # Start production server
160npm run test # Run tests
161npm run lint # Run linter
162npm run format # Format code
163```
164
165## File Locations and Navigation
166
167### Current Key Files
168- `/README.md` - Project overview and setup instructions
169- `/LICENSE` - MIT license terms
170- `/.gitignore` - Git ignore patterns (Node.js/Next.js focused)
171
172### Expected Important Locations (when populated)
173- `/src/` - Main source code directory
174- `/src/pages/` - Next.js pages (if Next.js project)
175- `/src/components/` - React components
176- `/public/` - Static assets and files
177- `/package.json` - Project configuration and dependencies
178- `/next.config.js` - Next.js configuration
179- `/tsconfig.json` - TypeScript configuration
180
181## AI Development Guidelines
182
183Since this is an AI setup repository:
184
1851. **Always verify AI-related dependencies** when they are added:
186 ```bash
187 # Common AI packages to look for
188 grep -E "(openai|langchain|tensorflow|pytorch|huggingface)" package.json
189 ```
190
1912. **Environment variables for AI services**:
192 ```bash
193 # Check for environment configuration
194 ls .env* || echo "No environment files found"
195 ```
196
1973. **API key management**:
198 - Never commit API keys
199 - Always use environment variables
200 - Check .env.example for required variables
201
202## Troubleshooting
203
204### Repository Appears Empty
205- This is expected in the current state
206- Check git branch: `git branch -a`
207- Look for other branches that might contain code
208
209### Build Failures
210- First verify package.json exists: `ls package.json`
211- Clear dependencies and reinstall: `rm -rf node_modules package-lock.json && npm install`
212- Check Node.js version compatibility in package.json
213
214### Development Server Issues
215- Verify port availability (typically 3000 for Next.js)
216- Check for environment variable requirements
217- Review console output for specific error messages
218
219## Critical Reminders
220
221- **NEVER CANCEL builds or long-running commands** - they may take 45+ minutes
222- **ALWAYS validate commands work** before assuming functionality exists
223- **CHECK for package.json** before running npm commands
224- **SET APPROPRIATE TIMEOUTS** - builds: 60+ minutes, tests: 30+ minutes
225- **VERIFY repository state** before attempting any operations
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−# Megarepo - AI Setup Repository
1+# AI Agents Configuration
22
3−**ALWAYS follow these instructions first and only fallback to additional search and context gathering if the information here is incomplete or found to be in error.**
3+## Overview
44
5−## Repository Overview
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.
66
7−Megarepo is currently a minimal repository template designed for AI-related projects. The repository contains basic setup files and is configured for Node.js/Next.js development based on the .gitignore patterns.
7+## Configured AI Agents
88
9−## Current Repository State
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
1017
11−**IMPORTANT**: This repository is currently in a minimal state with only basic setup files:
12−- README.md (basic project description)
13−- LICENSE (MIT license)
14−- .gitignore (configured for Node.js/Next.js projects)
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
1526
16−**DO NOT attempt to build, test, or run code** - there is no source code or build system present yet.
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
1736
18−## Working Effectively
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
1946
20−### Initial Repository Exploration
21−```bash
22−# Always start by understanding the current repository state
23−ls -la
24−git status
25−find . -type f -name "*.json" -o -name "*.js" -o -name "*.ts" -o -name "*.md"
26−```
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
2758
28−### When Source Code is Added
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
2971
30−The repository is pre-configured for Node.js/Next.js development. When source code is added, follow these patterns:
72+## Agent Coordination
3173
32−#### Node.js/Next.js Project Setup
33−```bash
34−# Check for package.json first
35−ls package.json
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
3679
37−# If package.json exists, install dependencies
38−npm install
39−# NEVER CANCEL: npm install typically takes 2-5 minutes. Set timeout to 10+ minutes.
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
4086
41−# Common build commands (verify these exist in package.json first)
42−npm run build
43−# NEVER CANCEL: Build may take 5-45 minutes depending on project size. Set timeout to 60+ minutes.
87+## Usage Guidelines
4488
45−# Common test commands
46−npm test
47−# NEVER CANCEL: Tests may take 5-15 minutes. Set timeout to 30+ minutes.
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
4894
49−# Common development server
50−npm run dev
51−```
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
52100
53−#### Pre-commit Validation
54−When source code exists, always run these before committing:
55−```bash
56−# Check for linting configuration
57−ls .eslintrc* eslint.config.* .prettierrc*
101+## Adding New Agents
58102
59−# Run linting if configured
60−npm run lint
103+When adding new AI agents to this repository:
61104
62−# Run formatting if configured
63−npm run format
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
64110
65−# Run type checking if TypeScript
66−npm run type-check
67−```
111+## Notes
68112
69−## Repository Structure Expectations
70−
71−Based on the .gitignore configuration, expect the following when the repository is populated:
72−
73−```
74−.
75−├── README.md # Project documentation
76−├── LICENSE # MIT license
77−├── .gitignore # Node.js/Next.js ignore patterns
78−├── package.json # Node.js dependencies and scripts
79−├── package-lock.json # Dependency lockfile
80−├── next.config.js # Next.js configuration (if Next.js)
81−├── tsconfig.json # TypeScript configuration (if TypeScript)
82−├── .eslintrc.* # ESLint configuration
83−├── .prettierrc # Prettier configuration
84−├── src/ # Source code directory
85−│ ├── pages/ # Next.js pages (if Next.js)
86−│ ├── components/ # React components
87−│ └── utils/ # Utility functions
88−├── public/ # Static assets
89−├── .next/ # Next.js build output (ignored)
90−├── build/ # Build output (ignored)
91−└── node_modules/ # Dependencies (ignored)
92−```
93−
94−## Validation Requirements
95−
96−### Before Making Changes
97−1. **Always check current repository state first**:
98− ```bash
99− git status
100− ls -la
101− cat package.json # Only if it exists
102− ```
103−
104−2. **Verify build system exists before attempting builds**:
105− ```bash
106− # Check for package.json before running npm commands
107− test -f package.json && echo "Node.js project detected" || echo "No package.json found"
108− ```
109−
110−### After Making Changes
111−1. **When source code is present, always validate**:
112− ```bash
113− # Install dependencies if package.json exists
114− test -f package.json && npm install
115−
116− # Build if build script exists
117− test -f package.json && npm run build
118−
119− # Test if test script exists
120− test -f package.json && npm test
121−
122− # Lint if lint script exists
123− test -f package.json && npm run lint
124− ```
125−
126−2. **Manual validation scenarios when application exists**:
127− - Start the development server and verify it loads
128− - Test basic functionality by navigating through the application
129− - Verify any API endpoints respond correctly
130− - Check console for errors
131−
132−## Common Commands Reference
133−
134−### Repository Information
135−```bash
136−# View current files
137−ls -la
138−
139−# Check git status
140−git status
141−
142−# View repository structure
143−tree . -a -I 'node_modules|.git' # If tree is available (use -a to show hidden files)
144−find . -type f -not -path "./.git/*" -not -path "./node_modules/*" | sort
145−```
146−
147−### When Package.json Exists
148−```bash
149−# View available scripts
150−cat package.json | grep -A 20 '"scripts"'
151−
152−# Install dependencies
153−npm install
154−# TIMEOUT: 10+ minutes
155−
156−# Common development commands (check package.json first)
157−npm run dev # Development server
158−npm run build # Production build
159−npm run start # Start production server
160−npm run test # Run tests
161−npm run lint # Run linter
162−npm run format # Format code
163−```
164−
165−## File Locations and Navigation
166−
167−### Current Key Files
168−- `/README.md` - Project overview and setup instructions
169−- `/LICENSE` - MIT license terms
170−- `/.gitignore` - Git ignore patterns (Node.js/Next.js focused)
171−
172−### Expected Important Locations (when populated)
173−- `/src/` - Main source code directory
174−- `/src/pages/` - Next.js pages (if Next.js project)
175−- `/src/components/` - React components
176−- `/public/` - Static assets and files
177−- `/package.json` - Project configuration and dependencies
178−- `/next.config.js` - Next.js configuration
179−- `/tsconfig.json` - TypeScript configuration
180−
181−## AI Development Guidelines
182−
183−Since this is an AI setup repository:
184−
185−1. **Always verify AI-related dependencies** when they are added:
186− ```bash
187− # Common AI packages to look for
188− grep -E "(openai|langchain|tensorflow|pytorch|huggingface)" package.json
189− ```
190−
191−2. **Environment variables for AI services**:
192− ```bash
193− # Check for environment configuration
194− ls .env* || echo "No environment files found"
195− ```
196−
197−3. **API key management**:
198− - Never commit API keys
199− - Always use environment variables
200− - Check .env.example for required variables
201−
202−## Troubleshooting
203−
204−### Repository Appears Empty
205−- This is expected in the current state
206−- Check git branch: `git branch -a`
207−- Look for other branches that might contain code
208−
209−### Build Failures
210−- First verify package.json exists: `ls package.json`
211−- Clear dependencies and reinstall: `rm -rf node_modules package-lock.json && npm install`
212−- Check Node.js version compatibility in package.json
213−
214−### Development Server Issues
215−- Verify port availability (typically 3000 for Next.js)
216−- Check for environment variable requirements
217−- Review console output for specific error messages
218−
219−## Critical Reminders
220−
221−- **NEVER CANCEL builds or long-running commands** - they may take 45+ minutes
222−- **ALWAYS validate commands work** before assuming functionality exists
223−- **CHECK for package.json** before running npm commands
224−- **SET APPROPRIATE TIMEOUTS** - builds: 60+ minutes, tests: 30+ minutes
225−- **VERIFY repository state** before attempting any operations
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
