SWE-ATLAS

Turn Claude Code into a senior software engineer with persistent identity, real engineering principles, and production-grade tooling.

npx swe-atlas@latest new-project

One command. Full setup. No copy-pasting prompts every session.

Why This Exists

The Neuron Activation Problem

AI coding assistants have deep engineering capabilities locked behind generic defaults. Ask "write a function" and you get code. Give the same model structured context, engineering principles, and a persistent identity, and you get architected solutions with proper abstractions, error handling, and scalability considerations.

The difference is neuron activation — the right instructions firing the right capabilities.

What Goes Wrong Without It

Context rot. Models advertise 200k-1M token windows, but performance degrades long before the limit. The 10,000th token is not as trustworthy as the 10th.

Vibecoding hangovers. 25% of Y Combinator startups have 95% AI-generated codebases. Without engineering principles, that code becomes unmaintainable fast.

Repetitive setup. Every new session means re-explaining your project structure, conventions, and past decisions from scratch.

The Fix

ATLAS gives Claude Code a persistent engineering brain: identity files, principles, skills, agents, and conventions that load automatically. No copy-pasting. No re-explaining. Just open the project and build.

Getting Started

Quick Start

# Scaffold into an existing project
cd your-project
npx swe-atlas@latest new-project

# Or scaffold into a new folder
npx swe-atlas@latest new-project my-workspace

The CLI asks for your name, project type, context templates, and MCP servers. Then scaffolds everything.

Manual Setup

git clone --recurse-submodules https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas
cd Software-Engineer-AI-Agent-Atlas

Then run /swe-atlas:new-project-context inside Claude Code.

After Setup

/swe-atlas:new-project-context           # Configure ATLAS for your project
/swe-atlas:prepare-blueprint             # Discovery interview (problem, vision, users, UX)
/swe-atlas:create-design-md              # Lock visual identity via HTML variant prototyping
/swe-atlas:create-blueprint              # Generate frozen foundation + phases
/swe-atlas:create-phase "phase-01-mvp"   # Scaffold a development phase
/feature-dev                             # Guided feature development
"Add user authentication"                # Or just describe what you need

What ATLAS Brings

ATLAS (Adaptive Technical Learning and Architecture System) operates as 7 roles: Software Engineer, Solution Architect, Software Architect, Tech Lead, Business Analyst, Product Owner, and UI/UX Designer.

17 Skills

| Skill | Command | What It Does | |-------|---------|--------------| | Abstraction Power | /abstraction-power | Pattern recognition — identify repeated patterns, extract reusable abstractions | | Frontend Design | /frontend-design | Production-grade web UI with anti-AI-slop methodology | | shadcn | /shadcn | shadcn/ui components, presets, registries, and project init | | Human Writing | /human-writing | Content indistinguishable from skilled human writers in any language — auto-loads language-specific AI-tells from languages/ (currently English default + Bahasa Indonesia; add more via languages/{iso}.md) | | PDF | /pdf | Read, merge, split, watermark, OCR, fill forms | | PPTX | /pptx | Create and edit slide decks | | DOCX | /docx | Create and edit Word documents | | XLSX | /xlsx | Spreadsheets with formulas, charts, data cleaning | | Canvas Design | /canvas-design | Visual art and posters as PNG/PDF | | Algorithmic Art | /algorithmic-art | Generative art using p5.js | | Theme Factory | /theme-factory | 10 professional themes for any artifact | | MCP Builder | /mcp-builder | Guide for creating MCP servers | | Find Skills | /find-skills | Discover and install skills from the Anthropic library | | Skill Creator | /skill-creator | Scaffold a new skill following the canonical format | | PostgreSQL Code Review | /postgresql-code-review | Review SQL/migrations for correctness and safety | | PostgreSQL Optimization | /postgresql-optimization | Diagnose slow queries, suggest indexes and rewrites | | Supabase Postgres Best Practices | /supabase-postgres-best-practices | Idiomatic Supabase + Postgres patterns (RLS, auth, storage) |

7 Agents

| Agent | Model | What It Does | |-------|-------|--------------| | code-architect | Opus | Feature architecture with implementation blueprints | | code-explorer | Opus | Trace execution paths, map architecture layers | | code-review | Sonnet (x5) | Multi-agent PR review with confidence scoring | | code-simplifier | Opus | Refine code for clarity while preserving functionality | | generator-discriminator-loop | Opus | GAN-inspired iterative review — loops until the discriminator finds no gaps | | qa-manual-tester | Inherit | Browser-based QA testing via Playwright | | commit | Sonnet | Git commits following ATLAS convention |

Commands

| Command | What It Does | |---------|--------------| | /swe-atlas:new-project-context | Initialize project context, configure conventions, set up workspace | | /swe-atlas:prepare-blueprint | Discovery interview — captures business problem, vision, users, UX intent into blueprint-prep/ | | /swe-atlas:create-design-md | Lock visual identity — discover, prototype 3 distinct HTML variants for browser comparison, iterate, then write .claude/rules/DESIGN.md in Stitch format (YAML tokens + canonical sections) | | /swe-atlas:create-blueprint | Intelligence-driven waterfall — produces frozen foundation (BLUEPRINT, PRD, CONTINGENCY, STACK, CONVENTIONS, ARCHITECTURE, INVENTORY, wireframes, scenarios, phases, ralph) | | /swe-atlas:create-phase "phase-01-mvp" | Create a development phase with specs, test cases, and structure | | /swe-atlas:create-phase-details | Add wireframes, data model, data flow, and roadmap to a phase | | /swe-atlas:create-tasks | Decompose a phase into codebase-aware tasks | | /feature-dev | Guided feature development with codebase exploration | | /run-be-fe | Run backend and frontend in background | | /qa-manual-test-run | Execute QA test cases (markdown TC-*.md run via Playwright MCP — never as .spec.ts scripts) | | /commit | Commit using sub-agent |

MCP Integration

Pre-configured in .mcp.json:

• Playwright — Browser automation for QA testing and UI verification
• PostgreSQL — Database access for queries and schema inspection

Repository Structure

├── CLAUDE.md                        # ATLAS identity & entry point
├── NOTES.md                         # Regular notes and important must-follow rules
├── self/                            # Identity and principles
│   ├── atlas.md                    # Persona, journey, work protocol
│   └── engineering.md              # Engineering principles, roles
├── repos/                           # Your projects (multi-repo mode)
├── .claude/
│   ├── skills/                     # 17 specialized skills
│   ├── agents/                     # 7 task-specific agents
│   ├── commands/                   # Slash commands
│   ├── hooks/                      # Task completion hooks
│   └── rules/                      # Project rules — conventions + DESIGN.md (auto-loaded)
├── docs/                            # Project documentation
│   └── external-information/       # Git submodules (Anthropic plugins & skills)
├── misc/                            # Working files
│   ├── automation-tests/           # QA test cases and results
│   ├── context-templates/          # All convention templates
│   └── prompts/                    # Prompt templates
└── .mcp.json                        # MCP server configuration

How It Works

Neuron Activation Through Structure

Just as biological neurons need specific patterns to fire, AI capabilities need structured activation. ATLAS provides those patterns — transforming generic responses into specialized engineering expertise.

Context Engineering > Context Size

Rather than relying on ever-larger context windows, ATLAS uses strategic context organization through CLAUDE.md files and modular conventions to maintain focus where it matters.

Vibecoding With Guardrails

Natural conversational programming with engineering discipline. Production-grade, industry-appropriate best practices are the default — with KISS, YAGNI, and DRY applied in balance. Every session starts with the same standards.

npx swe-atlas@latest new-project and start building.

ATLAS — FAANG experience for scale. Startup experience for pragmatism.