shuguang1994/project-blueprint
121Last commit Aug 14, 2026
project-blueprint DSH plugin
Project Blueprint is a reusable AI agent skill that transforms any new project into an AI-ready codebase in one sentence. It scans project files, classifies dependencies via a 3-tier engine, and dynamically assembles a customized AGENTS.md, documentation skeleton, CI/CD pipeline, and testing policy from a 70+ component knowledge base.
How to install the project-blueprint DSH plugin
dsh plugin --profile web add 'github:shuguang1994/project-blueprintCopying does not run this command. Review the repository and version before installing the project-blueprint DSH plugin.
project-blueprint DSH plugin data source
project-blueprint DSH plugin snapshot date: Aug 16, 2026
discovered
What the project-blueprint DSH plugin can do
- Autonomous file discovery: scans and classifies 30+ file patterns without preset checklist.
- Intelligent dependency classification: 3-tier (exact match, heuristic patterns, web search fallback).
- Dynamic AGENTS.md generation: assembled from 70+ component knowledge base, not a static template.
- Documentation system: A/B/C/D/E 5-tier classification, generated per business type (13 types).
- Multi-IDE support: auto-generates CLAUDE.md, .cursor/rules, copilot-instructions, and more.
- Incremental mode: only fills gaps on existing projects, never overwrites.
- MCP tool recommendation: auto-matches MCP tools from detected stack, outputs install commands.
- Self-evolving: generated AGENTS.md includes auto-maintenance rules that grow with the project.
Where the project-blueprint DSH plugin fits
- Initialize a new project with AI coding standards and conventions.
- Add missing AGENTS.md, docs, CI, and testing policy to an existing project incrementally.
- Set up a consistent development environment across multiple projects in a monorepo.
- Onboard AI agents to a project with vendor-specific breadcrumbs (Claude Code, Cursor, etc.).
Who the project-blueprint DSH plugin is for
- Developers who use AI coding assistants (Claude Code, Cursor, GitHub Copilot, etc.) and want consistent project conventions.
- Teams that want to automate the setup of AGENTS.md, documentation, and CI/CD across new projects.
project-blueprint DSH plugin limitations
- Requires an AI agent that supports the SKILL.md format (e.g., Claude Code, Cursor, GitHub Copilot).
- Node.js is required for `npx skills add` installation.
- Web search fallback needs internet access; unknown dependencies may be classified incorrectly if search fails.
- Generated AGENTS.md is a starting point; teams may need to refine conventions for specific workflows.
project-blueprint DSH plugin: from the repository README
Quoted from the shuguang1994/project-blueprint README, the upstream source of the project-blueprint DSH plugin. Copyright remains with the original authors.
> **One command to make any project AI-agent-ready.** > 一键为新项目建立完整 AI 编程规范体系。 [](LICENSE) [](https://skills.sh) **Topics** · [](https://github.com/topics/dsh-plugin) [](https://github.com/topics/deepseek-harness) [](https://github.com/topics/agent-skills) [](https://github.com/topics/claude-code) [](https://github.com/topics/cursor) [](https://github.com/topics/codex) [中文文档](README_CN.md) --- ## What is this? Project Blueprint is a reusable AI agent skill that transforms any new project into an AI-ready codebase in one sentence. It's not a static template — it's an **autonomous discovery engine**: scan your project files, intelligently classify dependencies, and dynamically
Read the full READMERepository license: MIT
project-blueprint DSH plugin questions
How do I install Project Blueprint as a DSH plugin?
Run `dsh plugin --profile web add 'github:shuguang1994/project-blueprint'` in your terminal. Make sure you have Node.js installed, as the plugin relies on `npx skills add` for installation. After adding, you can use the plugin by invoking it from your AI agent.
Does Project Blueprint overwrite my existing AGENTS.md?
No, Project Blueprint uses an incremental mode. It automatically detects if your project already has an AGENTS.md and evaluates its quality. If the existing file is complete, it skips generation; if partial, it supplements the missing parts; only if none exists, it creates a full one. This ensures your existing conventions are not overwritten.
Which AI agents are compatible with Project Blueprint?
Project Blueprint supports any AI agent that understands the SKILL.md format, including Claude Code, Cursor, GitHub Copilot, Codex, Windsurf, Trae, OpenCode, DeepSeek Harness, and 28+ more. The generated CLAUDE.md, .cursor/rules, and copilot-instructions ensure compatibility with popular agents.
What if my project uses an unknown dependency not in the knowledge base?
The plugin uses a 3-tier classification: exact match, heuristic pattern matching, and web search as a fallback. If a dependency is completely unknown, it will perform a real-time web search to gather information. However, the accuracy depends on internet availability and the quality of search results. You can also contribute to the knowledge base by adding entries to the project's repository.
Can I use Project Blueprint for an existing project with code already written?
Yes, Project Blueprint is designed for both new and existing projects. It scans the current project structure, detects the tech stack, and generates only what's missing. For example, it won't create a new CI pipeline if one already exists, but it will add AGENTS.md if absent. The incremental mode ensures no disruption to your existing workflow.