Active Development

Code with
Intent and Spec

Praxis bridges Intent‑Driven Development and Spec‑Driven Development into a single, coherent workflow — AI‑native, CLI‑first, intent‑centric.

bash
$ npm install -g @intoinside/praxis
+ @intoinside/praxis@latest — installed successfully ✓
$ praxis init my-project
✔ Product info created
✔ Folder structure initialised
$ praxis intent create "User authentication"
✔ Intent INT-001 created in .praxis/intents/wip/
$ ▋
Core Concepts

The three pillars of Praxis

Start from why, derive what, verify the how — continuously.

01

Intent

Describes the purpose, value, and constraints of a feature. Technology‑agnostic. Answers the foundational question: Why are we building this?

Purpose Value Constraints
02

Specification

A formal, verifiable description derived from an Intent. Acts as a contract. Answers: What must the system do?

Contracts Acceptance Criteria Test Cases
03

Drift Detection

Continuously checks for semantic drift — specs that no longer satisfy the intent, or code that implements features with no backing intent.

Alignment Audit Traceability
Features

Everything you need to stay aligned

Intent Management

Create, validate, and track intents over time. Enforce structure and clarity from day one.

praxis intent create "Payment gateway" praxis intent validate INT-001 praxis intent list

Spec Derivation

Generate initial specifications automatically from intents, maintaining full traceability between the two layers.

praxis spec derive --from-intent INT-001 praxis spec validate SPEC-001

Spec Implementation

Send a spec directly to the AI agent, which implements it in code. Verify compliance at any time.

praxis spec apply SPEC-001 praxis spec check SPEC-001

Background Agent

A standalone daemon with MQTT‑based distributed architecture. Horizontal scaling via shared subscriptions.

praxis agent broker praxis agent run praxis agent ask "Explain this project"

AI & IDE Integration

Slash‑command friendly from the start. Map any Praxis command to AI chat prompts in VS Code or any editor.

/praxis-intent-create /praxis-spec-derive /praxis-intent-check

Design Philosophy

✦ Intent is sacred — everything traces back to a reason.
✦ Specs are contracts — informal requirements are not enough.
✦ Code must justify itself — no feature without intent.
✦ AI is an assistant — Praxis stays deterministic and auditable.
Workflow

From Intent to Code

A clear, step‑by‑step process that keeps intent and implementation in sync.

1

Initialize

Bootstrap your project with Praxis, creating product‑info artifacts and ready‑to‑use folder structure.

praxis init my-project
2

Capture Intent

Express why you are building a feature. Review and enhance the generated intent document.

praxis intent create "…"
3

Derive Specs

Automatically generate formal specifications from the validated intent. Refine them if needed.

praxis spec derive --from-intent INT-001
4

Implement

Let the AI agent write the code from the spec. No guesswork — the contract is explicit.

praxis spec apply SPEC-001
5

Verify & Archive

Check that the implementation satisfies the spec, then archive both spec and intent.

praxis spec archive SPEC-001
Installation

Up and running in seconds

Praxis is a Node.js CLI written in TypeScript. Requires Node.js ≥ 18.

  • Global install via npm
  • Works with any IDE or AI Chat
  • CLI‑first, no GUI required
View on GitHub
Install Praxis
# Global installation
$ npm install -g @intoinside/praxis

# Verify installation
$ praxis --version
praxis/1.x.x

# Start your project
$ praxis init my-project
✔ Project initialised successfully