Thank you for your interest in contributing to AtlasMind! This guide covers development setup, conventions, and how to add new features.

• Node.js ≥ 18
• npm ≥ 9
• VS Code ≥ 1.95.0
• Git

git clone https://github.com/JoelBondoux/AtlasMind.git
cd AtlasMind
npm install

npm run compile      # One-shot TypeScript compilation
npm run watch        # Watch mode (recommended during development)

npm test             # Run all Vitest tests
npm run test:coverage # Run the CI coverage gate

npm run lint         # ESLint

npx vsce package     # Produces a .vsix file

1. Open the project in VS Code
2. Press F5 to launch the Extension Development Host
3. The @atlas chat participant becomes available

• Strict mode is enabled — no implicit any
• Use .js extension on all relative imports (Node16 module resolution)
• Prefer type imports for types only used in type positions:

  import type { ModelInfo } from '../types.js';

• One class per file for core services
• All shared interfaces live in src/types.ts — never duplicate types across files

Use Conventional Commits:

feat: add new skill for Docker management
fix: prevent path traversal in memory-write
docs: update routing algorithm documentation
refactor: extract cost calculation into helper
chore: update dependencies

1. Version bump in package.json using Semantic Versioning:
   • PATCH (0.0.x): bug fixes, docs, refactors
   • MINOR (0.x.0): new features, new commands, new UI
   • MAJOR (x.0.0): breaking changes to config, agent definitions, or memory format
2. CHANGELOG.md entry matching the version bump
3. Documentation updates for any changed interfaces (see table below)

When you make any of these changes, update the corresponding docs:

1. Create src/providers/<name>.ts implementing the ProviderAdapter interface from adapter.ts
2. Register the adapter in src/providers/index.ts
3. Add the provider ID to ProviderId in src/types.ts
4. Add model metadata to the model catalog
5. Update docs/model-routing.md and CONTRIBUTING.md

1. Create the skill file in src/skills/
2. Export a factory function returning a SkillDefinition
3. Register in src/skills/index.ts
4. Add tests in tests/skills/
5. Update docs/agents-and-skills.md

Default agents are defined in src/extension.ts during activation. To add a new built-in agent:

1. Add the AgentDefinition in activate() with builtIn: true
2. Register via agentRegistry.registerAgent()
3. Update docs/agents-and-skills.md

Coverage thresholds are currently enforced for service-layer modules under src/core, src/skills, src/memory, src/providers, src/mcp, and src/bootstrap. Webview-heavy src/views code and chat participant wiring in src/chat are excluded from the enforced threshold until dedicated integration tests are added.

Before submitting:

• npm run compile passes with 0 errors
• npm test — all suites pass
• npm run lint — no new warnings
• Version bumped in package.json
• CHANGELOG.md entry added
• Relevant docs updated
• Commit message follows conventional format

Be respectful, constructive, and inclusive. We follow standard open-source community guidelines.