Development Setup

This guide covers setting up a local development environment for contributing to the AEGIS ecosystem.

Prerequisites

Documentation Site (aegis-docs)

git clone https://github.com/aegis-initiative/aegis-docs.git
cd aegis-docs
npm install
npm run dev

The site runs at http://localhost:4321. Content pages are in src/content/docs/ — edit a Markdown file and the page reloads automatically.

Project Structure

aegis-docs/
  src/
    content/docs/    # Markdown content pages
    components/      # Astro components (Sidebar, Header, etc.)
    layouts/         # Page layouts
    pages/           # Route definitions
    plugins/         # Remark/Rehype plugins
  public/
    fonts/           # Web fonts
  astro.config.mjs   # Astro configuration

TypeScript SDK (aegis-sdk)

git clone https://github.com/aegis-initiative/aegis-sdk.git
cd aegis-sdk/packages/sdk-ts
npm install
npm run build
npm test

Python SDK (aegis-sdk)

git clone https://github.com/aegis-initiative/aegis-sdk.git
cd aegis-sdk/packages/sdk-py
python -m venv .venv
source .venv/bin/activate   # or .venv\Scripts\activate on Windows
pip install -e ".[dev]"
pytest

Governance Specifications (aegis-governance)

The governance repository contains Markdown specifications, JSON schemas, and a Python reference runtime:

git clone https://github.com/aegis-initiative/aegis-governance.git
cd aegis-governance

Governance Hub (aegis)

The central governance repo is documentation-only (Markdown, YAML, JSON Schema):

git clone https://github.com/aegis-initiative/aegis.git
cd aegis

No build step is required. ADRs are in docs/adr/, schemas in schemas/, doctrine in doctrine/.

Editor Recommendations

Next Steps