ajstack

AI-powered development operating system for consultants and development teams.

Overview

ajstack unifies:

• spec-kit - Spec-driven development templates & CLI
• GSD - Phase workflow, verification, state management
• superpowers - Brainstorming, TDD, subagent execution, code review
• agency-agents - 100+ specialized AI agent personas
• Industry Rockstar - Consulting methodology, assessments, workflow mapping

Installation

pip install ajstack

Quick Start

Development Workflow

# Initialize project
aj new my-project

# Specify feature
aj dev specify "User authentication with OAuth2"

# Plan implementation
aj dev plan auth-feature

# Create tasks
aj dev tasks auth-feature

# Validate quality gates
aj dev validate auth-feature

# Show workflow status
aj dev workflow

Consulting Workflow

# Start a consulting engagement
aj consult start "AI Assessment" --client acme

# Run Future Readiness Assessment
aj consult assess --type future_readiness

# Generate Key Findings Report
aj consult findings

# Map workflows
aj consult process-map --department sales
aj consult value-map

# Create workshop materials
aj consult workshop --type ai-accelerator

Agent Selection

# List available agents
aj agents list

# List all domains
aj agents domains

# Select agent for task
aj agents select --domain consulting --task "data analysis"

# Get agent recommendations
aj agents recommend --task "implement OAuth2" --domain development

# Show agent details
aj agents info agent-consultant-001

OpenCode Integration

# Generate OpenCode skills for your project
aj integration skills my-project --type development

# Install git hooks
aj integration hooks

# Start memory session
aj integration memory-start session-001 my-project

# Check memory status
aj integration memory-status session-001

# List all memory sessions
aj integration memory-list

Architecture

┌─────────────────────────────────────────────────────────────┐
│                     ajstack CLI Layer                        │
│  (Click-based CLI with development + consulting commands)   │
├─────────────────────────────────────────────────────────────┤
│                   Core Library Layer                         │
│  ┌──────────────┐ ┌──────────────┐ ┌──────────────────────┐ │
│  │ Consulting   │ │ Development  │ │ Agent Orchestration  │ │
│  │ Engine       │ │ Engine       │ │ Engine               │ │
│  └──────────────┘ └──────────────┘ └──────────────────────┘ │
├─────────────────────────────────────────────────────────────┤
│                   OpenCode Integration Layer                  │
│  ┌──────────────┐ ┌──────────────┐ ┌──────────────────────┐ │
│  │ Skills       │ │ Memory       │ │ Hooks                │ │
│  └──────────────┘ └──────────────┘ └──────────────────────┘ │
└─────────────────────────────────────────────────────────────┘

Commands

Development Commands

Command	Description
aj new	Initialize ajstack project
aj dev feature	Create new feature
aj dev status	Show feature status
aj dev specify	Generate feature specification
aj dev plan	Generate implementation plan
aj dev tasks	Generate task breakdown
aj dev validate	Run quality gate validation
aj dev workflow	Show development workflow status

Consulting Commands

Command	Description
aj consult start	Start consulting engagement
aj consult assess	Run assessment
aj consult findings	Generate Key Findings Report
aj consult process-map	Map workflows
aj consult value-map	Generate value map
aj consult workshop	Create workshop materials

Agent Commands

Command	Description
aj agents list	List available personas
aj agents domains	List all domains
aj agents select	Select agent for task
aj agents recommend	Get agent recommendations
aj agents info	Show agent details

Integration Commands

Command	Description
aj integration skills	Generate OpenCode skills
aj integration hooks	Install git hooks
aj integration memory-start	Start memory session
aj integration memory-status	Show session status
aj integration memory-list	List all sessions

Configuration

ajstack uses ajstack.yaml for project configuration:

project:
  name: my-project
  type: hybrid  # development, consulting, hybrid
  
consulting:
  methodology: industry-rockstar
  assessments:
    - future-readiness
    - ai-implementation
  
development:
  speckit: true
  gsd: true
  superpowers: true
  
agents:
  default_domain: engineering
  personality:
    analytical: 0.8
    structured: 0.7
    cautious: 0.6
    collaborative: 0.9
    data_driven: 0.8

integration:
  opencode:
    skills: true
    memory: true
    hooks: true

Development

Setup

git clone https://github.com/aljaunia/ajstack.git
cd ajstack
pip install -e ".[dev]"

Testing

# Run all tests
pytest

# Run with coverage
pytest --cov=ajstack --cov-report=term-missing

# Run specific test module
pytest tests/test_core/ -v

Linting

ruff check .
mypy ajstack/

Documentation

• Design Document
• API Reference
• Examples

License

MIT

Author

Abdullah Al-Jauni - abdullah.jaunid@gmail.com