blueprint-mode
v2.1.2Documented intent for AI-assisted development: ADRs, specs, patterns, requirements, DESIGN.md, and a separate design tree for UX decisions
By rickardpLicense: MIT2 GitHub starsUpdated 1 hour ago
Directory evidence
- Runtimes
- Codex and Claude Code
- Parsed components
- 12 skill or MCP entries
- Source updated
- Oct 1, 2026
- Manifest status
- Canonical path parsed
The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →
Install blueprint-mode for Codex and Claude Code
codex plugin marketplace add rickardp/blueprint-mode
codex plugin marketplace upgrade blueprint-mode
codex plugin add blueprint-mode@blueprint-modePaste and run these commands in a terminal with Codex. They add and refresh the blueprint-mode catalog, then install this plugin.
Compatibility: the page URL and API slug “blueprint-mode” remain stable.
- Codex:
blueprint-mode@agent-plugin-marketplace→blueprint-mode@blueprint-mode
The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.
Get the source manually
git clone https://github.com/rickardp/blueprint-modeClone the source repository, then follow its setup instructions to add the plugin to a compatible client. The plugin root is plugins/blueprint-mode/.
Plugin files
├── .codex-plugin/plugin.json├── .claude-plugin/plugin.json├── skills/bad-pattern/SKILL.md├── skills/decide/SKILL.md├── skills/good-pattern/SKILL.md├── skills/help/SKILL.md├── skills/list-adrs/SKILL.md├── skills/onboard/SKILL.md├── skills/onboard-design/SKILL.md├── skills/require/SKILL.md├── skills/setup-repo/SKILL.md├── skills/status/SKILL.md├── skills/supersede/SKILL.md└── skills/validate/SKILL.md
Included Skills12
Document something to avoid, with the correct alternative, in patterns/bad/anti-patterns.md. Use when the user says "don't do X" or corrects a recurring mistake.
Record architectural or UX decisions and their rationale. Use when the user states a choice and why, asks to document a decision, or asks to save agreed decisions, requirements, patterns, or progress from the conversation.
Save code, schema, UI, or a script as an approved example in patterns/good. Use when the user points at code and says it is the way to do it.
Explain Blueprint Mode and its workflows. Use when the user asks how Blueprint works, how to get started, or where a kind of document belongs.
List Architecture Decision Records grouped by status. Use when the user wants to see, filter, or search the ADRs.
Create the Blueprint code/architecture tree for an existing repository, or upgrade one set up by an earlier Blueprint version. Use when the user asks to add Blueprint to an existing repo or upgrade its documentation. Safe to rerun; later runs fill gaps.
Opt in to design intent capture by scaffolding design/ux-decisions, optionally a DESIGN.md stub, and optionally reviewing a few existing UI patterns for stated intent. Use when the user asks to set up or enable design intent capture; UI code alone is not a trigger. Safe to rerun.
Add a functional or non-functional requirement to docs/specs. Use when the user states what the product must do or a measurable target such as latency, uptime, or a security constraint.
Scaffold a brand-new project with Blueprint documentation and a test setup. Use when the user asks to create a new project with Blueprint; use onboard for an existing codebase.
Show what Blueprint has captured in this repo. Use when the user asks what decisions, specs, or patterns are documented, or whether the repo is set up for Blueprint.
Rewrite or retire an existing ADR or UX decision. Use when the user changes a documented choice, asks for an explicit replacement record, or retires a decision.
Check the codebase and its documentation against recorded decisions, boundaries, patterns, specs, and design intent. Use when the user asks for a consistency audit or whether the code still follows the documented decisions.
Plugin manifests2
{
"name": "blueprint-mode",
"version": "2.1.2",
"description": "Documented intent for AI-assisted development: ADRs, specs, patterns, requirements, DESIGN.md, and a separate design tree for UX decisions",
"author": {
"name": "rickardp",
"url": "https://github.com/rickardp"
},
"homepage": "https://github.com/rickardp/blueprint-mode",
"repository": "https://github.com/rickardp/blueprint-mode",
"license": "MIT",
"keywords": [
"specs",
"adr",
"architecture-decisions",
"maintainability",
"patterns",
"requirements",
"spec-driven",
"ux-decisions"
],
"skills": "./skills/",
"interface": {
"displayName": "Blueprint Mode",
"shortDescription": "Keep human intent explicit for AI agents",
"longDescription": "Blueprint Mode helps teams document architecture decisions, UX decisions, requirements, boundaries, and good and bad patterns so AI-assisted development stays consistent over time.",
"developerName": "rickardp",
"category": "Coding",
"capabilities": [
"Interactive",
"Write"
],
"websiteURL": "https://github.com/rickardp/blueprint-mode",
"privacyPolicyURL": "https://github.com/rickardp/blueprint-mode",
"termsOfServiceURL": "https://github.com/rickardp/blueprint-mode",
"defaultPrompt": [
"Onboard this repo into Blueprint Mode",
"Record an ADR for this architecture choice",
"Show the current Blueprint docs in this repo"
],
"screenshots": []
}
}{
"name": "blueprint-mode",
"description": "Documented intent for AI-assisted development: ADRs, specs, patterns, requirements, DESIGN.md, and a separate design tree for UX decisions",
"version": "2.1.2",
"author": {
"name": "rickardp"
},
"homepage": "https://github.com/rickardp/blueprint-mode",
"repository": "https://github.com/rickardp/blueprint-mode",
"license": "MIT",
"keywords": [
"specs",
"adr",
"architecture-decisions",
"maintainability",
"patterns",
"requirements",
"spec-driven",
"ux-decisions"
]
}For maintainers
If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.
[blueprint-mode on Agent Plugins Marketplace](https://pluginsmp.com/plugins/blueprint-mode)