guardian-framework 0.1.11 → 0.1.13

package/dist/cli.js

@@ -1335,7 +1335,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.11", description = "Token-optimized agentic framework scaffolder with pi-first architecture", type = "module", main = "dist/exports.js", exports, types = "dist/exports.d.ts", bin, files, engines, scripts, publishConfig, pi, repository, homepage = "https://github.com/arman-jalili/guardian-framework#readme", bugs, dependencies, devDependencies, keywords, author = "Arman Wolkensteiner-Jalili", license = "MIT", package_default;
+var name = "guardian-framework", version = "0.1.13", description = "Token-optimized agentic framework scaffolder with pi-first architecture", type = "module", main = "dist/exports.js", exports, types = "dist/exports.d.ts", bin, files, engines, scripts, publishConfig, pi, repository, homepage = "https://github.com/arman-jalili/guardian-framework#readme", bugs, dependencies, devDependencies, keywords, author = "Arman Wolkensteiner-Jalili", license = "MIT", package_default;
 var init_package = __esm(() => {
   exports = {
     ".": {

package/dist/exports.js

@@ -995,7 +995,7 @@ __export(exports_package, {
   bin: () => bin,
   author: () => author
 });
-var name = "guardian-framework", version = "0.1.11", description = "Token-optimized agentic framework scaffolder with pi-first architecture", type = "module", main = "dist/exports.js", exports, types = "dist/exports.d.ts", bin, files, engines, scripts, publishConfig, pi, repository, homepage = "https://github.com/arman-jalili/guardian-framework#readme", bugs, dependencies, devDependencies, keywords, author = "Arman Wolkensteiner-Jalili", license = "MIT", package_default;
+var name = "guardian-framework", version = "0.1.13", description = "Token-optimized agentic framework scaffolder with pi-first architecture", type = "module", main = "dist/exports.js", exports, types = "dist/exports.d.ts", bin, files, engines, scripts, publishConfig, pi, repository, homepage = "https://github.com/arman-jalili/guardian-framework#readme", bugs, dependencies, devDependencies, keywords, author = "Arman Wolkensteiner-Jalili", license = "MIT", package_default;
 var init_package = __esm(() => {
   exports = {
     ".": {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "guardian-framework",
-	"version": "0.1.11",
+	"version": "0.1.13",
 	"description": "Token-optimized agentic framework scaffolder with pi-first architecture",
 	"type": "module",
 	"main": "dist/exports.js",

package/templates/pi/extensions/architect-lib/generators.ts

@@ -7,6 +7,7 @@ export function generateIssueMarkdown(
 	slice: ArchitectureSlice,
 	issueIndex: number,
 	totalIssues: number,
+	codegenSkill?: string,
 ): string {
 	const moduleId = slice.module.replace(/^module-/, "");
 	const componentName = component.name.toLowerCase().replace(/\s+/g, "-");
@@ -64,6 +65,7 @@ ${component.dependencies.map((d) => `    - "${d}"`).join("\n")}
 
   implementation_notes: |
     ${component.description || "Implement this component according to the architecture module."}
+    ${codegenSkill ? `Follow: .pi/skills/agents/${codegenSkill}.md` : ""}
 
   file_changes:
     - "create: src/${moduleId}/${componentName}/"

package/templates/pi/extensions/architect-lib/helpers.ts

@@ -221,6 +221,27 @@ export function readGroupId(cwd: string): string {
     return "com.example";
 }
 
+export function readLanguage(cwd: string): string {
+    const manifestPath = join(cwd, "guardian-manifest.json");
+    try {
+        const raw = readFileSync(manifestPath, "utf-8");
+        const manifest = JSON.parse(raw) as { language?: string };
+        if (manifest.language) return manifest.language;
+    } catch {}
+    return "typescript";
+}
+
+export function codegenSkillName(language: string): string {
+    const map: Record<string, string> = {
+        "rust": "rust-codegen",
+        "go": "go-codegen",
+        "python": "python-codegen",
+        "typescript": "typescript-codegen",
+        "java": "java-codegen",
+    };
+    return map[language] || "typescript-codegen";
+}
+
 export function findModuleByName(cwd: string, name: string): string | null {
     const files = discoverModules(cwd);
     const nameLower = name.toLowerCase().replace(/[^a-z0-9]/g, "");

package/templates/pi/extensions/architect.ts

@@ -180,6 +180,29 @@ function readRepository(cwd: string): string | null {
 	return null;
 }
 
+function readLanguage(cwd: string): string {
+	const manifestPath = join(cwd, "guardian-manifest.json");
+	try {
+		if (existsSync(manifestPath)) {
+			const raw = readFileSync(manifestPath, "utf-8");
+			const manifest = JSON.parse(raw) as { language?: string };
+			if (manifest.language) return manifest.language;
+		}
+	} catch {}
+	return "typescript";
+}
+
+function codegenSkillName(language: string): string {
+	const map: Record<string, string> = {
+		rust: "rust-codegen",
+		go: "go-codegen",
+		python: "python-codegen",
+		typescript: "typescript-codegen",
+		java: "java-codegen",
+	};
+	return map[language] || "typescript-codegen";
+}
+
 /**
  * Get Git platform base URL. For GitLab, tries to detect self-hosted instances.
  */
@@ -693,6 +716,7 @@ function generateIssueMarkdown(
 	slice: ArchitectureSlice,
 	issueIndex: number,
 	totalIssues: number,
+	codegenSkill?: string,
 ): string {
 	const moduleId = slice.module.replace(/^module-/, "");
 	const componentName = component.name.toLowerCase().replace(/\s+/g, "-");
@@ -750,6 +774,7 @@ ${component.dependencies.map((d) => `    - "${d}"`).join("\n")}
 
   implementation_notes: |
     ${component.description || "Implement this component according to the architecture module."}
+    ${codegenSkill ? `Follow: .pi/skills/agents/${codegenSkill}.md` : ""}
 
   file_changes:
     - "create: src/${moduleId}/${componentName}/"
@@ -1275,6 +1300,8 @@ class EpicManager {
 		name: string,
 		trackingIssueId?: string,
 	): Promise<EpicState> {
+		const lang = readLanguage(this.cwd);
+		const skillName = codegenSkillName(lang);
 		const moduleFiles = discoverModules(this.cwd);
 		if (moduleFiles.length === 0) {
 			throw new Error("No architecture modules found in .pi/architecture/modules/.");
@@ -1411,7 +1438,7 @@ class EpicManager {
 				status: "planned" as string,
 				remoteIssueId: null as string | null,
 			};
-			const md = generateIssueMarkdown(comp, slice, i, slice.nextLogicalSlice.length);
+			const md = generateIssueMarkdown(comp, slice, i, slice.nextLogicalSlice.length, skillName);
 			writeFileSync(join(issuesDir, `${id}.md`), md);
 			if (hasRemote && remoteRepo) {
 				const result = createRemoteIssue(this.cwd, entry.title, join(issuesDir, `${id}.md`), "epic,implementation", remoteRepo);

package/templates/pi/preflight_report.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-07-03T04:44:32Z",
+  "timestamp": "2026-07-03T05:22:36Z",
   "mode": "all",
   "stages_run": [],
   "summary": {
@@ -8,7 +8,7 @@
     "failed": 1,
     "skipped": 12
   },
-  "duration_seconds": 1,
+  "duration_seconds": 0,
   "results": [
   {
     "name": "check_mr_traceability.sh",

package/templates/pi/scripts/ci/check_architecture_conformance.sh

@@ -674,7 +674,7 @@ check_import_boundaries() {
     esac
 
     # Basic check: no cross-layer violations
-    # Layer structure: app/domain → app/application → app/infrastructure → app/api
+    # DDD 4-layer structure: domain/ → application/ → infrastructure/ → interfaces/
     local violations=0
 
     for layer_dir in app/domain app/application app/infrastructure app/api src/domain src/application src/infrastructure src/api; do
@@ -682,20 +682,49 @@ check_import_boundaries() {
         while IFS= read -r file; do
             [[ -f "$file" ]] || continue
             if [[ "$layer_dir" == *"domain" ]]; then
-                if grep -qE "from.*infrastructure|from.*api|import.*infrastructure|import.*api" "$file" 2>/dev/null; then
+                if grep -qE "from.*infrastructure|from.*api|from.*interfaces|import.*infrastructure|import.*api|import.*interfaces" "$file" 2>/dev/null; then
                     ((violations++))
-                    log_fail "$check_name" "Domain layer imports from infrastructure/api in $(basename "$file")"
+                    log_fail "$check_name" "Domain layer imports from outer layer in $(basename "$file")"
                 fi
             fi
             if [[ "$layer_dir" == *"application" ]]; then
-                if grep -qE "from.*api|import.*api" "$file" 2>/dev/null; then
+                if grep -qE "from.*api|from.*interfaces|import.*api|import.*interfaces" "$file" 2>/dev/null; then
                     ((violations++))
-                    log_fail "$check_name" "Application layer imports from api in $(basename "$file")"
+                    log_fail "$check_name" "Application layer imports from api/interfaces in $(basename "$file")"
                 fi
             fi
         done < <(find "$layer_dir" -name "*.py" -o -name "*.ts" -o -name "*.rs" -o -name "*.go" 2>/dev/null | head -20)
     done
 
+    # Also check per-module 4-layer DDD structure directly under src/
+    local module_dirs
+    module_dirs=$(find src -mindepth 1 -maxdepth 1 -type d 2>/dev/null | sort)
+    for module_dir in $module_dirs; do
+        module=$(basename "$module_dir")
+        # Skip non-DDD modules (CLI, config, shared)
+        case "$module" in shared|common|config|lib|bin) continue ;; esac
+        
+        # Check contracts/ anti-pattern
+        if [[ -d "${module_dir}/contracts" ]]; then
+            log_fail "$check_name" "Module '${module}' has contracts/ wrapper — should use domain/ application/ infrastructure/ interfaces/"
+        fi
+        
+        # Check required DDD layers
+        local layers_present=0
+        local layers_missing=""
+        for layer in domain application infrastructure interfaces; do
+            if [[ -d "${module_dir}/${layer}" ]]; then
+                layers_present=$((layers_present + 1))
+            else
+                layers_missing="${layers_missing} ${layer}"
+            fi
+        done
+        
+        if [[ "$layers_present" -gt 0 ]] && [[ "$layers_present" -lt 4 ]]; then
+            log_fail "$check_name" "Module '${module}' has incomplete DDD layers (missing:${layers_missing})"
+        fi
+    done
+
     if [[ $violations -eq 0 ]]; then
         log_pass "Import boundary conformance (no cross-layer violations)"
     fi

package/templates/pi/scripts/ci/check_ddd_structure.sh

@@ -0,0 +1,290 @@
+#!/usr/bin/env bash
+# ============================================================================
+# check_ddd_structure.sh — Validate DDD Clean Architecture layer structure
+#
+# Ensures every module in src/ follows the correct 4-layer DDD structure:
+#   src/[module]/domain/
+#   src/[module]/application/
+#   src/[module]/infrastructure/
+#   src/[module]/interfaces/
+#
+# Also checks NO contracts/ wrapper exists (v0.1.10+ pattern) and validates
+# dependency direction (domain must not import from outer layers).
+#
+# Usage:
+#   bash .pi/scripts/ci/check_ddd_structure.sh              # Run all checks
+#   bash .pi/scripts/ci/check_ddd_structure.sh --module X   # Single module
+#   bash .pi/scripts/ci/check_ddd_structure.sh --fix        # Suggest fixes
+#
+# Exit: 0 = all modules conform, 1 = violations found
+# ============================================================================
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_ROOT="$(cd "${SCRIPT_DIR}/../../.." && pwd)"
+SRC_DIR="${PROJECT_ROOT}/src"
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+PASS_COUNT=0
+FAIL_COUNT=0
+ERRORS=()
+CHECK_MODE="full"
+SINGLE_MODULE=""
+
+# ── Options ──
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --module) SINGLE_MODULE="$2"; shift 2 ;;
+        --fix) CHECK_MODE="fix"; shift ;;
+        --help)
+            sed -n '3,14p' "$0" | sed 's/^#//'
+            exit 0
+            ;;
+        *) shift ;;
+    esac
+done
+
+pass() { echo -e "${GREEN}✅ PASS${NC} $1"; PASS_COUNT=$((PASS_COUNT + 1)); }
+fail() { echo -e "${RED}❌ FAIL${NC} $1"; FAIL_COUNT=$((FAIL_COUNT + 1)); ERRORS+=("$1"); }
+warn() { echo -e "${YELLOW}⚠️  WARN${NC} $1"; }
+
+echo "============================================"
+echo "  DDD Layer Structure Check"
+echo "============================================"
+echo ""
+
+# ── Language Detection ──
+detect_language() {
+    if [[ -f "${PROJECT_ROOT}/Cargo.toml" ]]; then echo "rust"
+    elif [[ -f "${PROJECT_ROOT}/go.mod" ]]; then echo "go"
+    elif [[ -f "${PROJECT_ROOT}/package.json" || -f "${PROJECT_ROOT}/tsconfig.json" ]]; then echo "typescript"
+    elif [[ -f "${PROJECT_ROOT}/pyproject.toml" || -f "${PROJECT_ROOT}/requirements.txt" ]]; then echo "python"
+    elif [[ -f "${PROJECT_ROOT}/pom.xml" || -f "${PROJECT_ROOT}/build.gradle" ]]; then echo "java"
+    else echo "unknown"; fi
+}
+
+PROJECT_LANG=$(detect_language)
+echo "Language: ${BLUE}${PROJECT_LANG}${NC}"
+echo ""
+
+# ── File extension mapping ──
+get_source_extensions() {
+    case "$1" in
+        rust) echo "rs" ;;
+        go) echo "go" ;;
+        typescript) echo "ts" ;;
+        python) echo "py" ;;
+        java) echo "java" ;;
+        *) echo "rs go ts py java" ;;
+    esac
+}
+
+get_import_pattern() {
+    # Returns regex patterns for import statements that violate dependency direction
+    case "$1" in
+        rust)
+            # Domain importing from infrastructure/application/interfaces is wrong
+            echo "use crate::.*infrastructure|use crate::.*application|use crate::.*interfaces"
+            ;;
+        go)
+            echo '"\.\./infrastructure|"\.\./application|"\.\./interfaces'
+            ;;
+        typescript)
+            echo "from.*infrastructure|from.*application|from.*interfaces"
+            ;;
+        python)
+            echo "from.*infrastructure|from.*application|from.*interfaces|import.*infrastructure|import.*application|import.*interfaces"
+            ;;
+        java)
+            echo "import.*infrastructure|import.*application|import.*interfaces"
+            ;;
+        *)
+            echo "infrastructure|application|interfaces"
+            ;;
+    esac
+}
+
+SRC_EXTS=$(get_source_extensions "$PROJECT_LANG")
+IMPORT_PATTERN=$(get_import_pattern "$PROJECT_LANG")
+
+# ── Discover modules ──
+declare -a MODULES
+if [[ -n "$SINGLE_MODULE" ]]; then
+    if [[ -d "${SRC_DIR}/${SINGLE_MODULE}" ]]; then
+        MODULES=("${SINGLE_MODULE}")
+    else
+        echo -e "${RED}Module '${SINGLE_MODULE}' not found in src/${NC}"
+        exit 1
+    fi
+else
+    # Find top-level directories in src/ — these are modules/bounded contexts
+    while IFS= read -r -d '' dir; do
+        module=$(basename "$dir")
+        # Skip shared/ common/ config/ if they exist
+        case "$module" in
+            shared|common|config|lib) continue ;;
+        esac
+        MODULES+=("$module")
+    done < <(find "$SRC_DIR" -mindepth 1 -maxdepth 1 -type d -print0 2>/dev/null | sort -z)
+fi
+
+if [[ ${#MODULES[@]} -eq 0 ]]; then
+    warn "No modules found in src/ — nothing to check"
+    echo ""
+    echo "============================================"
+    echo "  Summary"
+    echo "============================================"
+    echo -e "  Passed:   ${GREEN}${PASS_COUNT}${NC}"
+    echo -e "  Failed:   ${RED}${FAIL_COUNT}${NC}"
+    echo ""
+    echo -e "${YELLOW}No modules to validate.${NC}"
+    exit 0
+fi
+
+echo "Found ${#MODULES[@]} module(s): ${MODULES[*]}"
+echo ""
+
+# ── Required DDD layers ──
+DDD_LAYERS=("domain" "application" "infrastructure" "interfaces")
+
+# ── Check 1: Every module has the 4 DDD layers ──
+echo "--- Layer Structure ---"
+
+for module in "${MODULES[@]}"; do
+    module_dir="${SRC_DIR}/${module}"
+    missing=()
+    contracts_wrapper=false
+
+    # Check for contracts/ anti-pattern
+    if [[ -d "${module_dir}/contracts" ]]; then
+        contracts_wrapper=true
+    fi
+
+    for layer in "${DDD_LAYERS[@]}"; do
+        if [[ ! -d "${module_dir}/${layer}" ]]; then
+            missing+=("$layer")
+        fi
+    done
+
+    if [[ ${#missing[@]} -eq 0 ]] && [[ "$contracts_wrapper" == false ]]; then
+        pass "${module} — all 4 DDD layers present"
+    elif [[ ${#missing[@]} -eq 0 ]] && [[ "$contracts_wrapper" == true ]]; then
+        fail "${module} — has contracts/ wrapper (should be domain/ application/ infrastructure/ interfaces/)"
+    else
+        fail "${module} — missing layers: ${missing[*]}"
+    fi
+done
+
+echo ""
+
+# ── Check 2: No contracts/ wrapper ──
+echo "--- Anti-Pattern: contracts/ Wrapper ---"
+CONTRACTS_COUNT=0
+for module in "${MODULES[@]}"; do
+    if [[ -d "${SRC_DIR}/${module}/contracts" ]]; then
+        CONTRACTS_COUNT=$((CONTRACTS_COUNT + 1))
+
+        # In --fix mode, suggest the rename
+        if [[ "$CHECK_MODE" == "fix" ]]; then
+            echo -e "${YELLOW}   Would fix: git mv ${SRC_DIR}/${module}/contracts/* ${SRC_DIR}/${module}/ && rmdir ${SRC_DIR}/${module}/contracts${NC}"
+        fi
+    fi
+done
+
+if [[ $CONTRACTS_COUNT -eq 0 ]]; then
+    pass "No contracts/ wrapper directories found"
+else
+    fail "Found ${CONTRACTS_COUNT} module(s) with contracts/ wrapper — should use direct DDD layers"
+fi
+
+echo ""
+
+# ── Check 3: Dependency direction (domain must not import outer layers) ──
+echo "--- Dependency Direction ---"
+VIOLATIONS=0
+
+for module in "${MODULES[@]}"; do
+    domain_dir="${SRC_DIR}/${module}/domain"
+    if [[ ! -d "$domain_dir" ]]; then
+        continue
+    fi
+
+    # Find source files in domain/ and check for illegal imports
+    while IFS= read -r -d '' file; do
+        if grep -Eq "$IMPORT_PATTERN" "$file" 2>/dev/null; then
+            violations=$(grep -En "$IMPORT_PATTERN" "$file" 2>/dev/null || true)
+            if [[ -n "$violations" ]]; then
+                echo -e "${RED}   Illegal import in ${file}${NC}"
+                while IFS= read -r line; do
+                    echo "     ${line}"
+                done <<< "$violations"
+                VIOLATIONS=$((VIOLATIONS + 1))
+            fi
+        fi
+    done < <(find "$domain_dir" -type f \( -name "*.${SRC_EXTS%% *}" $(for ext in ${SRC_EXTS#* }; do echo -o -name "*.$ext"; done) \) -print0 2>/dev/null)
+done
+
+if [[ $VIOLATIONS -eq 0 ]]; then
+    pass "No dependency direction violations (domain does not import outer layers)"
+else
+    fail "Found ${VIOLATIONS} dependency direction violation(s) — domain/ must not import from outer layers"
+fi
+
+echo ""
+
+# ── Check 4: Repository interfaces defined in domain, implemented in infrastructure ──
+echo "--- Repository Pattern ---"
+REPO_INFRA_ONLY=0
+REPO_MISSING_INFRA=0
+
+for module in "${MODULES[@]}"; do
+    infra_repo_dir="${SRC_DIR}/${module}/infrastructure/repository"
+    domain_repo_file=""
+    
+    # Check for repository file in domain/
+    domain_repo=$(find "${SRC_DIR}/${module}/domain" -maxdepth 2 -name "*repository*" -o -name "*repo*" 2>/dev/null | head -1)
+    
+    # Check for repository implementation in infrastructure/
+    infra_repo=$(find "${SRC_DIR}/${module}/infrastructure" -maxdepth 3 -name "*repository*" -o -name "*repo*" 2>/dev/null | head -1)
+    
+    if [[ -n "$domain_repo" ]] && [[ -z "$infra_repo" ]]; then
+        warn "${module} — repository interface in domain/ but no implementation in infrastructure/"
+        REPO_MISSING_INFRA=$((REPO_MISSING_INFRA + 1))
+    fi
+done
+
+if [[ $REPO_MISSING_INFRA -eq 0 ]]; then
+    pass "Repository interfaces have implementations in infrastructure/ (where applicable)"
+else
+    warn "${REPO_MISSING_INFRA} module(s) with unreferenced repository interfaces"
+fi
+
+echo ""
+
+# ── Summary ──
+echo "============================================"
+echo "  Summary"
+echo "============================================"
+echo -e "  Language:       ${BLUE}${PROJECT_LANG}${NC}"
+echo -e "  Modules:        ${BLUE}${#MODULES[@]}${NC}"
+echo -e "  Passed:         ${GREEN}${PASS_COUNT}${NC}"
+echo -e "  Failed:         ${RED}${FAIL_COUNT}${NC}"
+echo ""
+
+if [[ ${#ERRORS[@]} -gt 0 ]]; then
+    echo "FAILURES:"
+    for err in "${ERRORS[@]}"; do
+        echo "  - $err"
+    done
+    echo ""
+    echo -e "${RED}DDD structure violations found. Fix before merging.${NC}"
+    exit 1
+fi
+
+echo -e "${GREEN}All modules conform to DDD Clean Architecture layer structure.${NC}"
+exit 0

package/templates/pi/skills/agents/go-codegen.md

@@ -0,0 +1,42 @@
+---
+name: go-codegen
+description: Minimal skill for Go code generation with DDD + Clean Architecture. References full patterns on demand — never loads inline. Use when implementing Go modules following enterprise patterns.
+model: inherit
+tools: [Read, Grep]
+---
+
+# Go Code Generation — DDD + Clean Architecture Patterns
+
+> Do NOT load the full reference document. Read specific sections when needed.
+> Full reference: `.pi/skills/go-enterprise-codegen.md`
+
+## Quick Reference
+
+| When you need... | Read this section |
+|-----------------|-------------------|
+| Module structure | Section 1 — 4-layer DDD layout + dependency direction |
+| Domain entities | Section 2 — entity.go, value.go, repository interface |
+| Error handling | Section 3 — *DomainError, ErrorCode, sentinel errors |
+| Application services | Section 4 — Service interface + implementation |
+| Repository impl | Section 5 — GORM/sql implementation pattern |
+| HTTP handlers | Section 6 — Handler → Service → Domain flow |
+| Configuration | Section 7 — envconfig/viper pattern |
+| Testing | Section 8 — unit tests, repository tests |
+| Anti-patterns | Section 9 — what NOT to do |
+| Project structure | Section 10 — cmd/ internal/ pkg/ layout |
+
+## DDD Layer Contract
+
+| Layer | Purpose | Dependencies |
+|-------|---------|-------------|
+| `domain/` | Pure business logic | None (stdlib only) |
+| `application/` | Use case orchestration | `domain/` |
+| `infrastructure/` | External adapters | `domain/` + `application/` |
+| `interfaces/` | API contracts | `application/` |
+
+## Rules
+- NEVER read full reference — read specific sections
+- Use `grep` + `Read offset/limit` to target sections
+- Follow the DDD layer structure — no `contracts/` wrapper
+- Always define repository interfaces in `domain/`, implement in `infrastructure/`
+- Always use typed `*DomainError`, never bare strings

package/templates/pi/skills/agents/java-codegen.md

@@ -0,0 +1,42 @@
+---
+name: java-codegen
+description: Minimal skill for Java/Spring Boot code generation with DDD + Clean Architecture. References full patterns on demand — never loads inline. Use when implementing Java modules following enterprise patterns.
+model: inherit
+tools: [Read, Grep]
+---
+
+# Java/Spring Boot Code Generation — DDD + Clean Architecture Patterns
+
+> Do NOT load the full reference document. Read specific sections when needed.
+> Full reference: `.pi/skills/java-spring-enterprise-codegen.md`
+
+## Quick Reference
+
+| When you need... | Read this section |
+|-----------------|-------------------|
+| Module structure | Section 1 — 4-layer DDD layout + dependency direction |
+| Domain entities | Section 2 — Entity.java, Value Object record, Repository interface |
+| Error handling | Section 3 — DomainError, ErrorCode enum |
+| Application services | Section 4 — @Service, interface + impl pattern |
+| Repository impl | Section 5 — JPA EntityManager repository |
+| REST controllers | Section 6 — @RestController, @ExceptionHandler |
+| Testing | Section 7 — MockMvc, @SpringBootTest |
+| Anti-patterns | Section 8 — what NOT to do |
+| Project structure | Section 9 — Maven/Gradle module layout |
+
+## DDD Layer Contract
+
+| Layer | Purpose | Dependencies |
+|-------|---------|-------------|
+| `domain/` | Pure business logic | None (pure Java, no Spring) |
+| `application/` | Use case orchestration | `domain/` |
+| `infrastructure/` | External adapters | `domain/` + `application/` |
+| `interfaces/` | API contracts | `application/` |
+
+## Rules
+- NEVER read full reference — read specific sections
+- Use `grep` + `Read offset/limit` to target sections
+- Follow the DDD layer structure — no `contracts/` wrapper
+- Domain layer has ZERO Spring annotations
+- Use constructor injection, NEVER field injection
+- Use `record` for value objects (Java 16+)

package/templates/pi/skills/agents/python-codegen.md

@@ -0,0 +1,41 @@
+---
+name: python-codegen
+description: Minimal skill for Python code generation with DDD + Clean Architecture. References full patterns on demand — never loads inline. Use when implementing Python modules following enterprise patterns.
+model: inherit
+tools: [Read, Grep]
+---
+
+# Python Code Generation — DDD + Clean Architecture Patterns
+
+> Do NOT load the full reference document. Read specific sections when needed.
+> Full reference: `.pi/skills/python-enterprise-codegen.md`
+
+## Quick Reference
+
+| When you need... | Read this section |
+|-----------------|-------------------|
+| Module structure | Section 1 — 4-layer DDD layout + dependency direction |
+| Domain entities | Section 2 — entity.py, value.py, repository ABC |
+| Error handling | Section 3 — DomainError, ErrorCode enum |
+| Application services | Section 4 — Service class |
+| Repository impl | Section 5 — SQLAlchemy implementation pattern |
+| API controllers | Section 6 — FastAPI route handlers, error mapping |
+| Testing | Section 7 — pytest unit tests |
+| Anti-patterns | Section 8 — what NOT to do |
+| Project structure | Section 9 — src/ module layout |
+
+## DDD Layer Contract
+
+| Layer | Purpose | Dependencies |
+|-------|---------|-------------|
+| `domain/` | Pure business logic | None (stdlib only) |
+| `application/` | Use case orchestration | `domain/` |
+| `infrastructure/` | External adapters | `domain/` + `application/` |
+| `interfaces/` | API contracts | `application/` |
+
+## Rules
+- NEVER read full reference — read specific sections
+- Use `grep` + `Read offset/limit` to target sections
+- Follow the DDD layer structure — no `contracts/` wrapper
+- Use `@dataclass(frozen=True)` for value objects
+- Use `ABC` for repository interfaces