Metadata-Version: 2.4
Name: ajstack
Version: 0.1.0
Summary: AI-powered development operating system
Project-URL: Homepage, https://github.com/aljaunia/ajstack
Project-URL: Repository, https://github.com/aljaunia/ajstack
Project-URL: Issues, https://github.com/aljaunia/ajstack/issues
Author-email: Abdullah Al-Jauni <abdullah.jaunid@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: ai,automation,cli,consulting,development
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: click>=8.1.0
Requires-Dist: jinja2>=3.1.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pyyaml>=6.0.0
Requires-Dist: rich>=13.0.0
Provides-Extra: dev
Requires-Dist: mypy>=1.0.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# 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

```bash
pip install ajstack
```

## Quick Start

### Development Workflow

```bash
# 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

```bash
# 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

```bash
# 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

```bash
# 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:

```yaml
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

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

### Testing

```bash
# Run all tests
pytest

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

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

### Linting

```bash
ruff check .
mypy ajstack/
```

## Documentation

- [Design Document](docs/design.md)
- [API Reference](docs/api/)
- [Examples](docs/examples/)

## License

MIT

## Author

Abdullah Al-Jauni - [abdullah.jaunid@gmail.com](mailto:abdullah.jaunid@gmail.com)
