https://github.com/mrz1836/atlas
🌐 AI Task Lifecycle Automation System for Go projects
https://github.com/mrz1836/atlas
ai atlas claude go mcp orchestrator sdd task-automation
Last synced: 2 months ago
JSON representation
🌐 AI Task Lifecycle Automation System for Go projects
- Host: GitHub
- URL: https://github.com/mrz1836/atlas
- Owner: mrz1836
- License: mit
- Created: 2025-12-25T22:34:47.000Z (5 months ago)
- Default Branch: master
- Last Pushed: 2026-02-14T21:41:27.000Z (3 months ago)
- Last Synced: 2026-02-15T05:14:01.457Z (3 months ago)
- Topics: ai, atlas, claude, go, mcp, orchestrator, sdd, task-automation
- Language: Go
- Homepage:
- Size: 35.9 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: .github/SECURITY.md
- Support: .github/SUPPORT.md
- Agents: .github/AGENTS.md
Awesome Lists containing this project
README
# 🗺️ Atlas
**AI handles the tedium. You focus on the craft.**
CI / CD
Quality
Security
Community
### Project Navigation
🚀 Installation
⚡ Quick Start
📚 Features
📖 Documentation
🔐 Security
🛠️ Code Standards
🤖 AI Guidelines
👥 Maintainers
🤝 Contributing
📝 License
## 🚀 Installation
**ATLAS** requires a [supported release of Go](https://golang.org/doc/devel/release.html#policy).
### Install via go install
```bash
go install github.com/mrz1836/atlas@latest
```
### Build from source
```bash
git clone https://github.com/mrz1836/atlas.git
cd atlas
go build -o bin/atlas .
```
## ⚡ Quick Start
ATLAS uses a workspace-based workflow. Each task runs in an isolated Git worktree with its own checkpoint-driven lifecycle.
### Start a new task
```bash
atlas start "Fix race condition in cache handler" --type bug
```
ATLAS creates a worktree, analyzes the codebase, generates an implementation plan, and waits for your approval.
### Review and approve the plan
```bash
atlas status
```
Shows all active workspaces and their current states. When a workspace is waiting for approval:
```bash
atlas approve ws-fix-race-condition-20260214-1447
```
ATLAS executes the plan, runs linters and tests, fixes issues automatically, and submits for final review when ready.
### Work on multiple tasks in parallel
```bash
atlas start "Add metrics endpoint" --type feature
atlas start "Update README examples" --type task
atlas status
```
Each workspace operates independently. You can approve, review, or abandon them in any order.
### Review and merge
```bash
atlas review ws-fix-race-condition-20260214-1447
```
Opens the workspace for inspection. When satisfied:
```bash
atlas merge ws-fix-race-condition-20260214-1447
```
ATLAS merges the changes back to your main branch and cleans up the worktree.
> 📖 **For complete command reference and workflow details, see the [Quick Start Guide →](docs/quick-start.md)**
## 📚 Features
### AI-Assisted Workflows
- **Spec-Driven Development (SDD):** Every task starts with analysis and planning
- **Multi-Model Support:** Claude Opus, Sonnet, Haiku, Gemini, GPT-4
- **Context-Aware:** ATLAS analyzes your codebase structure before making changes
- **Iterative Refinement:** Auto-fixes lint and test failures until clean
### Parallel Workspaces
- **Isolated Worktrees:** Each task runs in its own Git worktree
- **Independent Lifecycles:** Start, approve, review, and merge tasks in any order
- **No Branch Pollution:** Clean separation between your main branch and WIP tasks
### Checkpoint Approval System
- **Human-in-the-Loop:** ATLAS stops at critical decision points
- **Plan Review:** Approve implementation plans before execution
- **Final Review:** Inspect completed work before merging
- **Full Transparency:** Every step is logged and reviewable
### Quality Automation
- **Go Validation Protocol:** Automatic pre-commit hooks, formatting, linting, testing
- **Race Detection:** Runs tests with `-race` flag to catch concurrency issues
- **CI Integration:** Validates changes against your existing CI pipeline
- **Coverage Tracking:** Monitors test coverage across changes
### Developer Experience
- **Minimal Configuration:** Works out-of-the-box for Go projects
- **Status Dashboard:** Real-time view of all active workspaces
- **Clean Git History:** Commits are well-formed and descriptive
- **Resume Support:** Pick up interrupted work exactly where you left off
## 📖 Documentation
View the comprehensive documentation for ATLAS:
| Document | Description |
|----------|-------------|
| **[templates.md](docs/templates.md)** | Template system reference and step types |
| **[quick-start.md](docs/quick-start.md)** | Complete CLI reference and workflow guide |
> **Heads up!** ATLAS is experimental software under active development. The MVP focuses on Go projects with a spec-driven workflow. Support for other languages and frameworks is planned.
## 🔐 Security
### Important Disclaimer
> ⚠️ **Experimental Software — Use with Caution**
>
> ATLAS is experimental, open-source software provided "AS-IS" without warranty. By using ATLAS, you acknowledge:
>
> - **AI-Generated Code:** All code changes are generated by AI models and should be reviewed carefully
> - **Git Worktrees:** ATLAS creates and manages Git worktrees automatically—ensure you understand worktree behavior
> - **No Formal Audit:** This software has not undergone professional security auditing
> - **Execution Risk:** ATLAS runs commands (linters, tests, formatters) in your repository
> - **API Keys Required:** You must provide your own API keys for AI model access
> - **No Liability:** Authors accept no responsibility for data loss, corrupted repositories, or other damages
>
> **Always review AI-generated code before merging. Always commit your work before running ATLAS.**
For security issues, see our [Security Policy](.github/SECURITY.md) or contact: [atlas@mrz1818.com](mailto:atlas@mrz1818.com)
### Additional Documentation & Repository Management
Development Setup (Getting Started)
Install [MAGE-X](https://github.com/mrz1836/go-mage) build tool for development:
```bash
# Install MAGE-X for development and building
go install github.com/magefile/mage@latest
go install github.com/mrz1836/go-mage/magex@latest
magex update:install
```
Build Commands
View all build commands
```bash script
magex help
```
Common commands:
- `magex build` — Build the binary
- `magex test` — Run test suite
- `magex lint` — Run all linters
- `magex deps:update` — Update dependencies
GitHub Workflows
ATLAS uses the **Fortress** workflow system for comprehensive CI/CD:
- **fortress-test-suite.yml** — Complete test suite across multiple Go versions
- **fortress-code-quality.yml** — Code quality checks (gofmt, golangci-lint, staticcheck)
- **fortress-security-scans.yml** — Security vulnerability scanning
- **fortress-coverage.yml** — Code coverage reporting to Codecov
- **fortress-release.yml** — Automated binary releases via GoReleaser
See all workflows in [`.github/workflows/`](.github/workflows/).
Updating Dependencies
To update all dependencies (Go modules, linters, and related tools), run:
```bash
magex deps:update
```
This command ensures all dependencies are brought up to date in a single step, including Go modules and any managed tools. It is the recommended way to keep your development environment and CI in sync with the latest versions.
## 🛠️ Code Standards
Read more about this Go project's [code standards](.github/CODE_STANDARDS.md).
## 🤖 AI Usage & Assistant Guidelines
Read the [AI Usage & Assistant Guidelines](.github/CLAUDE.md) for details on how AI is used in this project and how to interact with AI assistants.
## 👥 Maintainers
| [
](https://github.com/mrz1836) |
|:------------------------------------------------------------------------------------------------:|
| [MrZ](https://github.com/mrz1836) |
## 🤝 Contributing
View the [contributing guidelines](.github/CONTRIBUTING.md) and please follow the [code of conduct](.github/CODE_OF_CONDUCT.md).
### How can I help?
All kinds of contributions are welcome :raised_hands:!
The most basic way to show your support is to star :star2: the project, or to raise issues :speech_balloon:.
You can also support this project by [becoming a sponsor on GitHub](https://github.com/sponsors/mrz1836) :clap:
or by making a [**bitcoin donation**](https://mrz1818.com/?tab=tips&utm_source=github&utm_medium=sponsor-link&utm_campaign=atlas&utm_term=atlas&utm_content=atlas) to ensure this journey continues indefinitely! :rocket:
[](https://github.com/mrz1836/atlas/stargazers)
## 📝 License
[](LICENSE)