Installation

Lamina works with any AI coding agent and any stack. Install once in your shell, then invoke Lamina with slash commands in agent chat — not with passive natural-language prompting.

Installation does not cause Lamina to activate. After install, open your project root and start a fresh agent session, then run /lamina-init directly.

Quick path

Shell — run the install command for your agent
Open your project root and start a fresh agent session so the skill loads
Agent chat — run /lamina-init <your product domain and primary users>

Continue with Quickstart for the full design → implement → verify loop.

Quick install


npx skills install aryaniyaps/lamina

Agent-specific installs

Cursor


npx skills add https://github.com/aryaniyaps/lamina -a cursor -y

Claude Code


npx skills add https://github.com/aryaniyaps/lamina -a claude-code -y

Codex / Pi / generic


npx skills add https://github.com/aryaniyaps/lamina -a codex -a pi -y

Prerequisites

An AI coding agent (Cursor, Claude Code, Codex, Gemini, Pi, or similar)
Any framework, database, and UI library — Lamina is stack-agnostic

No Node.js version requirement for skill install. Node.js 20+ is only needed if you run contract validation (lamina-orchestrator skill lib/validate-run.mjs) locally.

After install

Open the intended project root in your coding agent
Start a fresh agent session — skills load at session start
Run init directly in agent chat:


/lamina-init <your product domain and primary users>

Successful init produces and validates both .lamina/business-context.md and .lamina/personas.json. Run init once per project or domain; use /lamina-init update only when the business use case, market, scope, or actor cast materially changes.

Not sure which command to run? /lamina <what you are trying to do> is an optional router for discovery — not a required setup step and not a substitute for /lamina-init.

Update

Re-run the install command to pull the latest skill version:


npx skills install aryaniyaps/lamina

Start a new agent session after updating.

.gitignore guidance

Lamina writes to .lamina/ in your project. Whether to commit it depends on your team:

Approach	When
Commit `.lamina/`	Team wants shared contracts and verify history
Gitignore `.lamina/`	Personal experiments; regenerate locally

To exclude:


.lamina/

Uninstall

Remove the Lamina skill using your agent’s skill management tooling, or delete the installed skill directory. .lamina/ artifacts in your project are not removed automatically.

Source

Lamina is open source under the Apache License 2.0: github.com/aryaniyaps/lamina

Full documentation: lamina.dev

Next steps

Quickstart — run your first cycle
Troubleshooting — if commands are not recognized or init is blocked
What is Lamina? — understand what you installed