create-living-architecture 1.0.2 → 1.0.3

package/index.js

@@ -21,7 +21,7 @@ execSync('git init', { stdio: 'inherit' });
 
 // Copy starter template
 console.log('\nCreating structure');
-const templatePath = path.join(__dirname, '../../examples/starter-template');
+const templatePath = path.join(__dirname, 'templates');
 
 function copyRecursive(src, dest) {
   const entries = fs.readdirSync(src, { withFileTypes: true });

package/package.json

@@ -1,11 +1,15 @@
 {
   "name": "create-living-architecture",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Scaffold a Living Architecture project with gravitational code organization",
   "main": "index.js",
   "bin": {
     "create-living-architecture": "index.js"
   },
+  "files": [
+    "index.js",
+    "templates/"
+  ],
   "scripts": {
     "test": "echo \"No tests yet\" && exit 0"
   },

package/templates/ARCHITECTURE.md

@@ -0,0 +1,56 @@
+# Architecture
+
+This project uses [Living Architecture](https://github.com/demos-ra/living-architecture).
+
+Code organized by dependency gravity - heavy (pure logic) sinks to bottom, light (adapters) floats to top.
+
+## Layers
+
+**R1 • Domain** (heaviest - zero dependencies)
+- Core business logic
+- Entities, value objects, domain services
+- No framework dependencies
+
+**R2 • Database** (depends on domain only)
+- Data persistence
+- Repositories, DAOs
+- Database adapters
+
+**R3 • API** (orchestrates domain + database)  
+- Application services
+- Use cases, workflows
+- Business process coordination
+
+**R4 • Integrations** (lightest - adapts everything)
+- External system adapters
+- UI/presentation layer
+- Third-party services
+- HTTP, GraphQL, message queues
+
+## Dependency Rules
+
+Dependencies flow down only:
+```
+R4 → R3 → R2 → R1
+```
+
+- R1 imports nothing
+- R2 imports only R1
+- R3 imports R1, R2
+- R4 imports all
+
+Violations caught by git hooks.
+
+## Benefits
+
+**Swap layers independently:**
+- Change database? Only R2 affected
+- Change UI framework? Only R4 affected  
+- Core business logic never touched
+
+**Git history = architecture:**
+```bash
+git log --oneline
+```
+
+Shows which layer each change affected.

package/templates/README.md

@@ -0,0 +1,28 @@
+# Starter Template
+
+Example Living Architecture project structure.
+
+## Structure
+
+```
+src/
+  domain/         R1 - Zero dependencies
+  database/       R2 - Depends on domain
+  api/            R3 - Orchestrates
+  integrations/   R4 - External systems + UI
+```
+
+## Usage
+
+```bash
+npx create-living-architecture my-project
+```
+
+## Commit Examples
+
+```
+Domain: Add user entity [R1/C2]
+Database: Add user repository [R2/C2]
+API: Add registration endpoint [R3/C2]
+Integrations: Add SendGrid email [R4/C2]
+```

package/templates/src/api/README.md

@@ -0,0 +1,13 @@
+# API Layer (R3)
+
+Depends on: Domain (R1), Database (R2)
+
+## Examples
+- REST endpoints
+- GraphQL resolvers
+- Request handlers
+- Response formatting
+
+## Rules
+Can import from: R1, R2
+Cannot import from: R4

package/templates/src/database/README.md

@@ -0,0 +1,13 @@
+# Database Layer (R2)
+
+Depends on: Domain (R1)
+
+## Examples
+- User repository
+- Order repository
+- Database connections
+- Migrations
+
+## Rules
+Can import from: R1
+Cannot import from: R3, R4

package/templates/src/domain/README.md

@@ -0,0 +1,12 @@
+# Domain Layer (R1)
+
+Zero dependencies. Core business logic.
+
+## Examples
+- User entity
+- Order entity
+- Value objects
+- Business rules
+
+## Rules
+Cannot import from: Database (R2), API (R3), Integrations (R4)

package/templates/src/integrations/README.md

@@ -0,0 +1,13 @@
+# Integrations Layer (R4)
+
+Depends on: All layers
+
+## Examples
+- SendGrid email
+- Stripe payments
+- Auth0 authentication
+- React/Vue UI components
+
+## Rules
+Can import from: R1, R2, R3
+External systems and UI live here

package/templates/starter-template/ARCHITECTURE.md

@@ -0,0 +1,56 @@
+# Architecture
+
+This project uses [Living Architecture](https://github.com/demos-ra/living-architecture).
+
+Code organized by dependency gravity - heavy (pure logic) sinks to bottom, light (adapters) floats to top.
+
+## Layers
+
+**R1 • Domain** (heaviest - zero dependencies)
+- Core business logic
+- Entities, value objects, domain services
+- No framework dependencies
+
+**R2 • Database** (depends on domain only)
+- Data persistence
+- Repositories, DAOs
+- Database adapters
+
+**R3 • API** (orchestrates domain + database)  
+- Application services
+- Use cases, workflows
+- Business process coordination
+
+**R4 • Integrations** (lightest - adapts everything)
+- External system adapters
+- UI/presentation layer
+- Third-party services
+- HTTP, GraphQL, message queues
+
+## Dependency Rules
+
+Dependencies flow down only:
+```
+R4 → R3 → R2 → R1
+```
+
+- R1 imports nothing
+- R2 imports only R1
+- R3 imports R1, R2
+- R4 imports all
+
+Violations caught by git hooks.
+
+## Benefits
+
+**Swap layers independently:**
+- Change database? Only R2 affected
+- Change UI framework? Only R4 affected  
+- Core business logic never touched
+
+**Git history = architecture:**
+```bash
+git log --oneline
+```
+
+Shows which layer each change affected.

package/templates/starter-template/README.md

@@ -0,0 +1,28 @@
+# Starter Template
+
+Example Living Architecture project structure.
+
+## Structure
+
+```
+src/
+  domain/         R1 - Zero dependencies
+  database/       R2 - Depends on domain
+  api/            R3 - Orchestrates
+  integrations/   R4 - External systems + UI
+```
+
+## Usage
+
+```bash
+npx create-living-architecture my-project
+```
+
+## Commit Examples
+
+```
+Domain: Add user entity [R1/C2]
+Database: Add user repository [R2/C2]
+API: Add registration endpoint [R3/C2]
+Integrations: Add SendGrid email [R4/C2]
+```

package/templates/starter-template/src/api/README.md

@@ -0,0 +1,13 @@
+# API Layer (R3)
+
+Depends on: Domain (R1), Database (R2)
+
+## Examples
+- REST endpoints
+- GraphQL resolvers
+- Request handlers
+- Response formatting
+
+## Rules
+Can import from: R1, R2
+Cannot import from: R4

package/templates/starter-template/src/database/README.md

@@ -0,0 +1,13 @@
+# Database Layer (R2)
+
+Depends on: Domain (R1)
+
+## Examples
+- User repository
+- Order repository
+- Database connections
+- Migrations
+
+## Rules
+Can import from: R1
+Cannot import from: R3, R4

package/templates/starter-template/src/domain/README.md

@@ -0,0 +1,12 @@
+# Domain Layer (R1)
+
+Zero dependencies. Core business logic.
+
+## Examples
+- User entity
+- Order entity
+- Value objects
+- Business rules
+
+## Rules
+Cannot import from: Database (R2), API (R3), Integrations (R4)

package/templates/starter-template/src/integrations/README.md

@@ -0,0 +1,13 @@
+# Integrations Layer (R4)
+
+Depends on: All layers
+
+## Examples
+- SendGrid email
+- Stripe payments
+- Auth0 authentication
+- React/Vue UI components
+
+## Rules
+Can import from: R1, R2, R3
+External systems and UI live here