Skip to content

truongnat/aix

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

799 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

aix

AI engineering methodology + 160+ skills, delivered as a Claude Code and Codex plugin.

The host agent is the runtime. aix is the playbook and the skill library — not a separate engine you invoke.

How it works

git clone https://github.com/truongnat/aix

Claude Code:

/plugin install /path/to/aix

Codex:

codex plugin marketplace add truongnat/aix
codex plugin add aix@aix

On start, a SessionStart hook injects using-aix into context. It explains the 8-step engineering spine and how to reach any of the 160+ skills via the host's Skill tool.

No engine, no runtime — just skills the agent pulls in when needed.

The engineering spine

# Phase Skill
1 Align & Shape discussing-pro
2 Plan planning-pro
3 Isolate git-worktree-pro
4 Test-first ttd-pro
5 Execute executing-pro
6 Review code-review-pro
7 Verify verify-pro
8 Remember remember-pro

Providers

Install skills to other AI coding tools:

npx @x/cli install --all --provider cursor|codex|gemini

Monorepo

13 packages for authoring, compiling, and headless execution:

Package Role
@x/registry SKILL.md schema (Zod), loader, catalog
@x/policy Secret/PII redaction, shell denylist
@x/providers Compile-time adapters + runtime LLM client
@x/compiler Idempotent file emitter
@x/context Code analysis, RAG, wiki generation
@x/memory Markdown store for durable memory
@x/prompt Prompt assembly + linter
@x/engine Headless SDLC runner for CI/batch
@x/cli Command surface
@x/core Types, phase machine, guards
@x/evals A/B harness + rubric scoring
@x/hitl Human-in-the-loop channel
@x/preview Mermaid / image / HTML preview
services/kb-server SQLite knowledge base

Quick start

pnpm install
pnpm build
pnpm test

CLI

aix install --all [--provider <claude|cursor|codex|gemini>]
aix run "<task>"
aix skills list | show <name> | validate
aix memory push|search|list|get
aix verify | ship
aix eval <suite>
aix doctor

Repository

.agents/plugins/  Codex marketplace entry for this repo
.claude-plugin/   Claude Code plugin manifest
.codex-plugin/    Codex plugin manifest
hooks/            SessionStart → injects using-aix + starts kb-server
content/
  skills/         160+ domain, process, and reference skills
  rules/          Spine guardrail rules
  workflows/      Engineering spine flow
packages/         13 @x/* TypeScript packages
services/         kb-server (SQLite, NestJS)
apps/             Docs site + tooling

Security

  • Secrets redacted at the boundary via @x/policy before hitting disk
  • Shell denylist + budget hard-stop guard the headless engine

License

MIT

About

AI Engineering Platform — TS monorepo consolidating skills, guardrail + autonomous SDLC, graph KB, and author-once compile to Claude/Cursor/Codex/Gemini

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages