Skip to content

Commit 433ab87

Browse files
docs: add Why structkit? comparison section to README
Adds the "Why structkit?" section between Key Features and Quick Start, including a competitor comparison table (structkit vs cookiecutter vs copier) and key differentiator descriptions. Part of open-source marketing strategy. Co-Authored-By: Paperclip <noreply@paperclip.ing>
1 parent a71a614 commit 433ab87

1 file changed

Lines changed: 36 additions & 0 deletions

File tree

README.md

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,42 @@
2222
- **✅ Validation & Schema** - Built-in YAML validation and IDE support
2323
- **🤖 MCP Integration** - Model Context Protocol support for AI-assisted development workflows
2424

25+
## 🤔 Why structkit?
26+
27+
Project scaffolding tools exist in most ecosystems, but structkit solves problems the others don't.
28+
29+
### The problem with copy-paste and "golden repos"
30+
31+
Most teams start with a "just copy the reference project" approach. This works until:
32+
- The reference repo falls out of date
33+
- Different teams diverge on standards
34+
- Onboarding a new engineer takes half a day of tribal knowledge transfer
35+
- A security baseline change means updating 20 repos manually
36+
37+
### How structkit is different
38+
39+
| Feature | cookiecutter | copier | **structkit** |
40+
|---|---|---|---|
41+
| Remote content (GitHub, S3, GCS, HTTP) ||||
42+
| AI / MCP integration ||||
43+
| Pre/post generation hooks ||||
44+
| Dry run mode ||||
45+
| YAML-first (no template repo required) ||||
46+
| Multiple file conflict strategies ||||
47+
| IDE schema validation ||||
48+
49+
**Key differentiators:**
50+
51+
- **Remote-first content:** Reference your organization's canonical CI template from GitHub directly in your structkit config. When the template updates, all new projects get the update — no copy-paste maintenance.
52+
- **AI-native via MCP:** structkit ships a Model Context Protocol server. Your AI assistant can generate project scaffolds from natural language, using your templates as the source of truth.
53+
- **YAML-first:** Define structures directly in YAML. No need to manage a separate template repository.
54+
55+
### Who uses structkit?
56+
57+
- **Platform / DevEx teams** enforcing org-wide project standards across all services
58+
- **DevOps engineers** generating consistent Terraform modules, K8s manifests, and CI pipelines
59+
- **Individual developers** tired of recreating the same boilerplate across projects
60+
2561
## 🚀 Quick Start
2662

2763
### Installation

0 commit comments

Comments
 (0)