@bcelep/prismx
v3.3.0
Published
AI-native development framework - skills, workflows and quality gates for any IDE or AI coding agent
Maintainers
Readme
🔷 PrismX
AI-native development framework
One source (.prismx/), every agent — skills, workflows, Karpathy constitution, cross-IDE projection
Current release: @bcelep/[email protected] · npm publish pending
What is PrismX?
PrismX gives AI coding agents structured discipline instead of ad-hoc prompts:
- 113+ expert skills and 17 workflows in
.prismx/ - Karpathy constitution (P1–P4) — think first, minimum code, surgical diffs, evidence before “done”
- Capability-first routing —
prismx routeprints short Execution Intent;--verbosefor debug table - Task → skill routing — agent selects capability/provider; user does not memorize skill names
- Cross-session memory —
HANDOFF.md,DONE.md, wiki - Cross-IDE projection — one canonical install, native hooks for Cursor, Claude, Codex, Gemini, OpenCode, Antigravity
.prismx/ ← single source of truth
├── skills/ (113+ playbooks)
├── workflows/ (17 step-by-step)
├── rules/ (karpathy-core, quality gates)
├── AGENT.md (session protocol)
└── projections/ (canonical → ide sync)
prismx ide sync ──► .cursor/rules/*.mdc | CLAUDE.md | GEMINI.md
.agents/rules/* (Antigravity) | opencode.jsonQuick start (recommended)
cd your-project
npx @bcelep/prismx init --preset product
npx @bcelep/prismx ide sync
npx @bcelep/prismx doctor --ideproduct preset installs 15 curated skills, AGENTS.md, ./rules/ scaffold, and runs IDE sync.
Preview skill routing before you chat:
npx @bcelep/prismx route "close open TODOs and add unit tests"
npx @bcelep/prismx route --listPresets
| Preset | When | Skills |
|--------|------|--------|
| product | Daily product development | 15 + rules + ide sync |
| verdent | Verdent global toolkit | ~59 + catalog |
| minimal | Trial / protocol only | 3 core |
| full | Everything in templates | 136 |
| web-app | Frontend-heavy | ~131 |
| api-service | Backend API | ~116 |
| mobile | React Native / Flutter | subset |
npx @bcelep/prismx init --preset verdent
npx @bcelep/prismx init --preset minimal --migrate # legacy .agents/ → .prismx/Commands
| Command | Description |
|---------|-------------|
| prismx init [--preset product] [--ide-agents] [--migrate] | Install .prismx/ in project |
| prismx doctor [--ide] | Health check (exit 1 on critical issues) |
| prismx route "<task>" | Skill Plan preview (weight, skills, workflow) |
| prismx ide sync [--targets …] | Project session rules to native IDE files |
| prismx ide check | Verify projection files exist |
| prismx rules scaffold [--stack laravel\|generic] | Create ./rules/ stack templates |
| prismx skill list \| info \| add \| remove | Skill management |
| prismx registry sync \| status | Registry ↔ disk alignment |
| prismx uninstall [--yes] | Remove .prismx/ + prismx IDE projections |
| prismx version | Show version |
Cross-IDE compatibility
PrismX is IDE-agnostic. Runtime always lives in .prismx/; ide sync writes each tool’s native entry format.
| IDE | Grade | ide sync output |
|-----|:-----:|-------------------|
| Cursor | A | .cursor/rules/00-prismx-session.mdc (alwaysApply) |
| Claude Code | B | CLAUDE.md |
| Codex / OpenAI | B | root AGENTS.md |
| Gemini CLI | B | GEMINI.md |
| OpenCode | C | opencode.json skills path |
| Antigravity | B− | .agents/rules/, PRISMX.md, prismx-router |
# Default: cursor, claude, gemini, opencode, codex, antigravity
npx @bcelep/prismx ide sync
npx @bcelep/prismx ide sync --targets antigravity,cursor,codexAntigravity: skills stay in .prismx/skills/ (not duplicated). Pin .agents/PRISMX.md as a Knowledge Item in the UI (manual step).
Full matrix: templates/wiki/conventions/ide-compatibility.md
Karpathy constitution (P1–P4)
Read first every session — .prismx/rules/karpathy-core.md:
| Principle | Agent behavior | |-----------|----------------| | P1 Think before coding | Stop and ask when unclear | | P2 Simplicity | Minimum code that works | | P3 Surgical changes | Only what was requested | | P4 Targeted completion | “Done” = test/log evidence |
Task → skill routing
| Layer | Role |
|-------|------|
| prismx-skill-gateway | Silent keyword routing (🟢) |
| task-skill-router | Skill Plan + reasoning (🟡/🔴) |
| skill-routing-matrix.json | Machine-readable mappings |
| prismx-skills-catalog | Master index (113+ skills) |
| verdent-skills-catalog | 55 Verdent-imported skills |
Complexity router: 🟢 light · 🟡 medium (plan required) · 🔴 heavy (workflow chain). Security areas → minimum 🟡.
Core skills (always in minimal)
| Skill | Purpose |
|-------|---------|
| prismx-skill-gateway | Route queries to expert skills |
| sequential-thinking | Structured reasoning |
| verification-before-completion | Evidence gates before “done” |
Product preset adds: session-context-primer, task-skill-router, systematic-debugging, test-driven-development, incident-response, dependency-audit, and more.
Workflows (17)
| Workflow | Purpose |
|----------|---------|
| /quickstart | Where to begin |
| /genesis | New feature / PRD |
| /blueprint | Technical design / TASKS |
| /forge | Implement + test |
| /challenge | Review before merge |
| /explore | Research / POC |
| /audit | Registry + quality check |
| /upgrade | Post-framework upgrade |
| … | See .prismx/workflows/ |
Uninstall
npx @bcelep/prismx uninstall --yes
npx @bcelep/prismx uninstall --yes --remove-agents --remove-rulesRemoves .prismx/, prismx-marked Cursor/Claude/Gemini/OpenCode files, and Antigravity projections (.agents/rules/00-prismx*, PRISMX.md, prismx-router).
Documentation
| Doc | Language | Topic | |-----|----------|-------| | CLI_RELEASE_3.2.1.md | EN | This release | | templates/wiki/PRISMX_KULLANIM_KILAVUZU.md | TR | Full user guide (§11 Cross-IDE) | | templates/wiki/conventions/ide-compatibility.md | EN | IDE matrix | | templates/wiki/conventions/task-to-skill-cheatsheet.md | EN | Task → skill cheatsheet |
Legacy migration
npx @bcelep/prismx init --preset minimal --migrate
npx @bcelep/prismx registry syncCopies legacy .agents/, .anws/, etc. into .prismx/ without deleting old dirs.
Changelog
| Version | Highlights |
|---------|------------|
| 3.2.1 | Antigravity ide sync, IDE compatibility doc, kılavuz §11 |
| 3.2.0 | prismx-skills-catalog, uninstall, Verdent gateway rows |
| 3.1.0 | Global rules, product preset, engineering profiles |
| 3.0.0 | .prismx/ canonical install, registry sync, migrate |
See CLI_RELEASE_3.2.1.md.
Skill sources & credits
PrismX integrates skills from PrismX Core, Verdent (55 skills, attributed), addyosmani/agent-skills, Karpathy principles, and community collections. See skill origin frontmatter and Acknowledgments below.
Contributing
See CONTRIBUTING.md.
License
🙏 Acknowledgments
- multica-ai/andrej-karpathy-skills — P1–P4 constitutional philosophy
- addyosmani/agent-skills — code quality, TDD, debugging
- buraksu42/skill-gateway — gateway routing concept
- Verdent global skills — 55 imported playbooks with attribution
- Open-source community — every skill author who shared their work
