https://github.com/fabioc-aloha/alex-cognitive-architecture

Cognitive architecture that turns any AI assistant into a proactive organizational teammate, then puts that teammate in command of a fleet of specialist agents working on the user's behalf. Persistent memory across projects, calibrated confidence, proactive risk gates, one intent dispatched to the right specialist with attribution intact.
https://github.com/fabioc-aloha/alex-cognitive-architecture

agent agentic-ai ai-agents ai-assistant chatgpt claude cognitive-architecture dialog-engineering fleet generative-ai github-copilot governance mcp multi-agent orchestration prompt-engineering

Last synced: 16 days ago
JSON representation

Cognitive architecture that turns any AI assistant into a proactive organizational teammate, then puts that teammate in command of a fleet of specialist agents working on the user's behalf. Persistent memory across projects, calibrated confidence, proactive risk gates, one intent dispatched to the right specialist with attribution intact.

• Host: GitHub
• URL: https://github.com/fabioc-aloha/alex-cognitive-architecture
• Owner: fabioc-aloha
• License: other
• Created: 2026-04-18T21:09:18.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2026-04-27T02:52:44.000Z (about 2 months ago)
• Last Synced: 2026-04-27T04:27:14.339Z (about 2 months ago)
• Topics: agent, agentic-ai, ai-agents, ai-assistant, chatgpt, claude, cognitive-architecture, dialog-engineering, fleet, generative-ai, github-copilot, governance, mcp, multi-agent, orchestration, prompt-engineering
• Language: JavaScript
• Size: 33.7 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

README

          
# Alex Cognitive Architecture

![Alex — Your AI Learning Partner](assets/banner.png)

[![Version](https://vsmarketplacebadges.dev/version/fabioc-aloha.alex-cognitive-architecture.svg)](https://marketplace.visualstudio.com/items?itemName=fabioc-aloha.alex-cognitive-architecture)

[![Installs](https://vsmarketplacebadges.dev/installs-short/fabioc-aloha.alex-cognitive-architecture.svg)](https://marketplace.visualstudio.com/items?itemName=fabioc-aloha.alex-cognitive-architecture)

[![License](https://img.shields.io/github/license/fabioc-aloha/alex-cognitive-architecture)](https://github.com/fabioc-aloha/alex-cognitive-architecture/blob/main/LICENSE.md)

**Your cognitive learning partner for VS Code.** Alex installs a living brain of skills, instructions, and prompts that makes GitHub Copilot dramatically smarter in any project.

## What Alex Does

Alex enhances GitHub Copilot with a **cognitive architecture** — domain knowledge, behavior rules, and reusable workflows that load automatically based on what you're working on.

| Component | Count | Role |

|-----------|-------|------|

| **Skills** | 195 | Domain knowledge for security, API design, testing, debugging, and more |

| **Instructions** | 167 | Behavior rules that auto-load based on file patterns |

| **Prompts** | 41 | Reusable workflow templates for common tasks |

| **Agents** | 22 | Specialized personas: Builder, Researcher, Validator, and more |

## Features

- **Brain Bootstrap** — One-click install of the cognitive architecture into any workspace

- **Muscle-First Commands** — Brain health, skill validation, token cost, markdown lint, and more run real code first, then open chat for AI follow-up

- **2-Tab Sidebar** — Loop (creative workflow + health monitoring), Setup (configuration + tools) — brand-aligned indigo design

- **Health Pulse** — Real-time brain health monitoring with ritual tracking and actionable nudges

- **Creative Loop** — Ideate → Plan → Build → Test → Release → Improve workflow

- **Chat Participant** — `@alex` in Copilot Chat with context-aware routing

- **File Converters** — 11 format converters (Markdown ↔ HTML/Word/PDF/PPTX/EPUB/LaTeX/Email/Plain Text) via right-click context menu

- **Specialized Agents** — Builder, Researcher, Validator, Documentarian, Planner, Presenter, and more

## Platforms

### VS Code Extension

The primary surface — install from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=fabioc-aloha.alex-cognitive-architecture).

### MCP Server

Use Alex's cognitive tools from any MCP-compatible client (Claude Desktop, Cline, etc.). See [MCP Server docs](https://github.com/fabioc-aloha/alex-cognitive-architecture/wiki/MCP-Server) for setup.

## Quick Start

1. Install from [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=fabioc-aloha.alex-cognitive-architecture)

2. Open the Alex sidebar (brain icon in Activity Bar)

3. Click **Install Brain** to deploy the cognitive architecture

4. Open Copilot Chat and start collaborating

## Documentation

- [Getting Started](https://github.com/fabioc-aloha/alex-cognitive-architecture/wiki/Getting-Started)

- [User Manual](https://github.com/fabioc-aloha/alex-cognitive-architecture/wiki/User-Manual)

- [Heir Project Setup](https://github.com/fabioc-aloha/alex-cognitive-architecture/wiki/Heir-Project-Setup)

- [FAQ](https://github.com/fabioc-aloha/alex-cognitive-architecture/wiki/FAQ)

- [Migration: v7 → v8](https://github.com/fabioc-aloha/alex-cognitive-architecture/wiki/Migration-v7-to-v8)

## Requirements

- **VS Code** 1.117 or later

- **GitHub Copilot** subscription

## License

[PolyForm Noncommercial 1.0.0](LICENSE.md)

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md)