@educa-corp/sdd-framework 0.6.0 → 0.7.0

package/hooks/data-guard.js

@@ -1,232 +0,0 @@
-#!/usr/bin/env node
-/**
- * data-guard.js — Claude Code PreToolUse Hook
- *
- * Chặn AI đọc/ghi/thực thi trên file nhạy cảm (credential, secret, private key, .env…).
- *
- * Cài: copy vào project + đăng ký trong .claude/settings.json
- * (mẫu: hooks/settings.json — hoặc dùng `npx @educa-corp/sdd-framework --hooks`)
- *
- * Exit code:
- *   0 = cho phép
- *   2 = chặn cứng (Claude Code hiểu mã này là block)
- *
- * ── VÌ SAO BẢN NÀY KHÁC BẢN ĐẦU (GAPS-v3 G42) ────────────────────────────────
- *
- * Bản đầu có ba lỗi độc lập; hai trong số đó chặn đúng công việc mà framework tồn
- * tại để làm, và cái còn lại làm lời hứa bảo mật không đúng:
- *
- *   (a) matcher thiếu `Grep` — `Grep` với output_mode:"content" trên `.env` TRẢ VỀ
- *       nội dung file và không đi qua hook. Nên câu "AI will be blocked from reading
- *       .env" là sai.
- *   (b) pattern soi CẢ PATH, không neo. `/password/i` khớp
- *       `specs/auth/forgot-password/UC1.feature` và `src/auth/PasswordResetController.java`
- *       ⇒ một framework sinh code từ spec KHÔNG LÀM NỔI feature auth khi bật hook
- *       của chính nó.
- *   (c) Bash soi cả command string ⇒ `git commit -m "feat: password reset UC1"` bị
- *       chặn — đúng câu commit mà các lệnh hướng dẫn chạy ở cuối pipeline.
- *
- * Cả hai đường đều dẫn tới cùng một kết cục: người dùng TẮT HOOK, và mất luôn phần
- * bảo vệ thật. Một guard bị tắt bảo vệ bằng không.
- *
- * ── MÔ HÌNH MỚI ──────────────────────────────────────────────────────────────
- *
- * Secret sống trong file CẤU HÌNH/DỮ LIỆU, không sống trong file MÃ NGUỒN.
- * `secrets.json` là kho bí mật; `PasswordResetController.java` là code.
- * Nên pattern chung (secret/credential/password/token/api-key) chỉ áp cho file
- * KHÔNG phải mã nguồn. Pattern cứng (.env, .pem, .key…) áp cho mọi file.
- * Cộng thêm allowlist thư mục làm việc của framework (specs/, .trace/, docs/…).
- */
-
-// ── Thư mục làm việc của framework — không bao giờ chứa secret thật ───────────
-// Tên feature ("forgot-password", "api-key-rotation") hay khớp pattern chung, và
-// đây chính là chỗ ca (b) nổ. Cho qua TRƯỚC khi soi.
-const SAFE_DIR_PREFIXES = [
-  'specs/', '.trace/', '.trace-mirror/', '.living-docs/',
-  'docs/', '.agent/', 'feedback/', '.claude/',
-];
-
-// ── Đuôi file MÃ NGUỒN — pattern chung không áp ───────────────────────────────
-// Một file .java/.ts/.dart tên gì đi nữa cũng là code, không phải kho secret.
-// (Pattern CỨNG bên dưới vẫn áp — nhưng .pem/.key không nằm trong danh sách này.)
-const CODE_EXT = new Set([
-  'java', 'kt', 'kts', 'scala', 'groovy',
-  'ts', 'tsx', 'js', 'jsx', 'mjs', 'cjs', 'vue', 'svelte',
-  'py', 'go', 'rs', 'rb', 'php', 'cs', 'fs', 'vb',
-  'swift', 'm', 'mm', 'dart', 'c', 'h', 'cpp', 'hpp', 'cc',
-  'sql', 'graphql', 'proto', 'feature', 'md', 'mdx', 'txt',
-  'html', 'css', 'scss', 'less', 'tsv', 'csv',
-]);
-
-// ── Pattern CỨNG — áp cho mọi file, soi TÊN FILE ─────────────────────────────
-const SENSITIVE_NAME_HARD = [
-  /^\.env$/i,
-  /^\.env\./i,
-  /\.env$/i,
-
-  /\.key$/i,
-  /\.pem$/i,
-  /\.p12$/i,
-  /\.pfx$/i,
-  /\.jks$/i,
-  /\.keystore$/i,
-  /^id_rsa$/i,
-  /^id_ed25519$/i,
-
-  /^application-(prod|production|staging)\.(yml|yaml|properties)$/i,
-  /^appsettings\.(Production|Staging)\.json$/i,
-  /^database\.yml$/i,
-  /^master\.key$/i,
-  /^oauth-private\.key$/i,
-  /^credentials$/i,
-  /^\.npmrc$/i,
-  /^\.pypirc$/i,
-  /^\.netrc$/i,
-];
-
-// ── Pattern CHUNG — chỉ áp cho file KHÔNG phải mã nguồn, soi TÊN FILE ────────
-const SENSITIVE_NAME_SOFT = [
-  /secret/i,
-  /credential/i,
-  /password/i,
-  /passwd/i,
-  /private[_-]?key/i,
-  /api[_-]?key/i,
-  /access[_-]?token/i,
-  /auth[_-]?token/i,
-];
-
-// ── Pattern THƯ MỤC — soi cả path ────────────────────────────────────────────
-const SENSITIVE_DIR = [
-  /(^|\/)secrets?\//i,
-  /(^|\/)\.secrets?\//i,
-  /(^|\/)\.ssh\//i,
-  /(^|\/)\.aws\//i,
-  /(^|\/)\.gnupg\//i,
-];
-
-// ── Lệnh bash nguy hiểm bất kể path ──────────────────────────────────────────
-const SENSITIVE_BASH = [
-  /\bprintenv\b/i,
-  /\benv\b\s*(\||$)/i,
-  /kubectl\s+get\s+secrets?\b[^|]*-o\s*(yaml|json)/i,
-  /\baws\s+secretsmanager\s+get-secret-value/i,
-  /\bgcloud\s+secrets\s+versions\s+access/i,
-  /\bvault\s+(read|kv\s+get)\b/i,
-  // `docker inspect` KHÔNG chặn cả cụm (lệnh debug thường dùng) — chỉ chặn khi nó
-  // thực sự moi Env ra. Bản đầu chặn cả cụm và đó là ma sát không đổi lấy gì.
-  /docker\s+inspect[^|]*\.Config\.Env/i,
-];
-
-// ── Helpers ──────────────────────────────────────────────────────────────────
-
-function normalize(p) {
-  return String(p).replace(/\\/g, '/').replace(/^\.\//, '');
-}
-
-function extOf(base) {
-  const i = base.lastIndexOf('.');
-  return i > 0 ? base.slice(i + 1).toLowerCase() : '';
-}
-
-function isSensitivePath(filePath) {
-  if (!filePath) return false;
-  const p = normalize(filePath);
-
-  // Vùng làm việc của framework — spec/trace/doc không chứa secret thật, và tên
-  // feature ở đó hay khớp pattern chung. Bỏ cả tiền tố tuyệt đối trước khi so.
-  const relish = p.replace(/^([a-zA-Z]:)?\/+/, '');
-  if (SAFE_DIR_PREFIXES.some(d => relish.startsWith(d) || relish.includes('/' + d))) return false;
-
-  if (SENSITIVE_DIR.some(re => re.test(p))) return true;
-
-  const base = p.split('/').pop() || '';
-  if (SENSITIVE_NAME_HARD.some(re => re.test(base))) return true;
-
-  // Pattern chung: bỏ qua mã nguồn. Đây là chỗ bản đầu chặn PasswordResetController.java.
-  if (CODE_EXT.has(extOf(base))) return false;
-  return SENSITIVE_NAME_SOFT.some(re => re.test(base));
-}
-
-/**
- * Tách các token TRÔNG GIỐNG PATH ra khỏi một command line.
- * Bản đầu soi cả chuỗi lệnh nên `git commit -m "feat: password reset"` bị chặn.
- */
-function pathishTokens(command) {
-  return String(command)
-    .split(/[\s;|&()<>]+/)
-    .map(t => t.replace(/^["']|["']$/g, ''))
-    .filter(t => t && !t.startsWith('-') && /[\/.]/.test(t) && !/^-{1,2}/.test(t));
-}
-
-function block(reason, detail) {
-  console.error(`\n🔒 DATA GUARD — BLOCKED\n${reason}`);
-  if (detail) console.error(detail);
-  console.error('\nCần giá trị cấu hình? Mô tả thứ bạn cần mà KHÔNG đưa secret thật;');
-  console.error('dùng placeholder trong code sinh ra.');
-  console.error('Nghĩ đây là chặn nhầm? Vùng specs/ .trace/ docs/ .agent/ luôn được cho qua,');
-  console.error('và file mã nguồn (.java/.ts/.dart…) không bị pattern chung đụng tới.\n');
-  process.exit(2);
-}
-
-// ── Main ─────────────────────────────────────────────────────────────────────
-
-let rawInput = '';
-process.stdin.setEncoding('utf8');
-process.stdin.on('data', chunk => { rawInput += chunk; });
-process.stdin.on('end', () => {
-  let input;
-  try {
-    input = JSON.parse(rawInput);
-  } catch {
-    // Fail-open CÓ CHỦ Ý: hook parse lỗi mà chặn hết thì làm cả project đứng máy.
-    // Nhưng không im lặng — im lặng là cách một guard chết mà không ai biết.
-    console.error('⚠️  data-guard: không parse được input hook — CHO QUA (fail-open).');
-    process.exit(0);
-  }
-
-  const tool = input.tool_name || '';
-  const arg  = input.tool_input || {};
-
-  switch (tool) {
-    case 'Read':
-    case 'Write':
-    case 'Edit':
-    case 'NotebookEdit': {
-      const f = arg.file_path || arg.notebook_path || '';
-      if (isSensitivePath(f)) block(`Thao tác ${tool} trên file nhạy cảm: ${f}`);
-      break;
-    }
-
-    // Grep ĐỌC ĐƯỢC NỘI DUNG (output_mode: "content"). Thiếu nhánh này thì mọi thứ
-    // ở trên chỉ là cửa trước, còn cửa sau mở toang — chính là lỗi (a) của G42.
-    case 'Grep': {
-      const target = arg.path || '';
-      if (target && isSensitivePath(target)) {
-        block(`Grep nhắm vào path nhạy cảm: ${target}`);
-      }
-      if (arg.glob && isSensitivePath(String(arg.glob).replace(/\*/g, 'x'))) {
-        block(`Grep dùng glob nhắm vào file nhạy cảm: ${arg.glob}`);
-      }
-      // Đang đi TÌM chính chuỗi secret — chặn kèm lý do khác hẳn.
-      if (arg.pattern && /\b(BEGIN [A-Z ]*PRIVATE KEY|aws_secret_access_key|sk-[A-Za-z0-9]{16,})/i
-          .test(String(arg.pattern))) {
-        block(`Grep đang tìm chính giá trị bí mật: ${String(arg.pattern).slice(0, 40)}…`);
-      }
-      break;
-    }
-
-    case 'Bash': {
-      const cmd = arg.command || '';
-      if (SENSITIVE_BASH.some(re => re.test(cmd))) {
-        block(`Lệnh moi secret: ${cmd.slice(0, 120)}`);
-      }
-      // CHỈ soi token trông giống path — không soi cả chuỗi lệnh (lỗi (c) của G42).
-      const hit = pathishTokens(cmd).find(isSensitivePath);
-      if (hit) block(`Lệnh bash chạm file nhạy cảm: ${hit}`, `   (trong: ${cmd.slice(0, 120)})`);
-      break;
-    }
-  }
-
-  process.exit(0);
-});

package/hooks/settings.json

@@ -1,19 +0,0 @@
-{
-  "_comment": "Claude Code hook registration template. Copy this content into your project's .claude/settings.json",
-  "_matcher_note": "Grep BẮT BUỘC có trong matcher: Grep với output_mode:content ĐỌC ĐƯỢC nội dung file, nên thiếu nó thì việc chặn Read chỉ là cửa trước (GAPS-v3 G42a).",
-  "_docs": "https://docs.anthropic.com/claude/claude-code/hooks",
-
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "Read|Write|Edit|Grep|NotebookEdit|Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node .claude/hooks/data-guard.js"
-          }
-        ]
-      }
-    ]
-  }
-}

package/modules/android-compose/module.yaml

@@ -1,13 +0,0 @@
-name: "Android (Jetpack Compose)"
-version: "1.0.0"
-description: "Native Android development with Jetpack Compose + Kotlin"
-language: "Kotlin"
-framework: "Jetpack Compose"
-stack_type: "mobile"
-default_layer_order:
-  - Domain models
-  - Repository (data layer)
-  - UseCase (domain logic)
-  - ViewModel (StateFlow<UiState>)
-  - Composable screens (presentation)
-test_framework: "JUnit5 + MockK + Turbine"

package/modules/android-compose/stack-profile.yaml

@@ -1,57 +0,0 @@
-build:
-  compile: "./gradlew assembleRelease"
-  test: "./gradlew test"
-  run: "./gradlew installDebug / Open in Android Studio → Run"
-  lint: "./gradlew lint"
-
-architecture:
-  style: "MVVM + Clean Architecture (Composable → ViewModel → UseCase → Repository)"
-  key_rules:
-    - "Composables are pure UI functions — no business logic, no direct suspend calls"
-    - "ViewModels expose StateFlow<UiState>; Composables collect via collectAsStateWithLifecycle()"
-    - "UseCases are single-responsibility classes injected into ViewModels"
-    - "Repositories are interfaces; implementations live in the data layer"
-    - "Dependency injection via Hilt"
-    - "Never launch coroutines from a Composable directly — use LaunchedEffect or ViewModel"
-  folder_structure: |
-    src/main/java/{package}/
-    ├── core/
-    │   ├── network/      ← Retrofit instance, interceptors
-    │   ├── theme/        ← MaterialTheme, Color, Type, Shape
-    │   └── utils/
-    ├── shared/
-    │   └── components/   ← reusable Composables (AppButton, AppTextField...)
-    ├── features/
-    │   └── {domain}/
-    │       ├── ui/           ← Composable screens + components
-    │       ├── viewmodel/    ← ViewModel + UiState
-    │       ├── domain/       ← UseCases, domain models
-    │       └── data/         ← Repository impl, data sources
-
-coding_standards:
-  naming:
-    composables: "PascalCase (e.g., OrderListScreen, CreateOrderForm)"
-    viewmodels: "PascalCase + ViewModel suffix (e.g., OrderListViewModel)"
-    usecases: "PascalCase + UseCase suffix (e.g., CreateOrderUseCase)"
-    files:
-      screen: "{Feature}Screen.kt"
-      viewmodel: "{Feature}ViewModel.kt"
-      usecase: "{Feature}UseCase.kt"
-  patterns:
-    state_management: "StateFlow<UiState> in ViewModel"
-    navigation: "Jetpack Navigation Compose"
-    networking: "Retrofit + OkHttp"
-    serialization: "Kotlinx Serialization or Gson"
-    di: "Hilt"
-    async: "Kotlin Coroutines + Flow"
-
-testing:
-  unit: "JUnit5 + MockK + Turbine (Flow testing)"
-  ui: "Compose UI Test (composeTestRule)"
-  patterns:
-    - "Test ViewModel with fake repositories and TestCoroutineDispatcher"
-    - "UI tests use semantics matchers — set Modifier.testTag() on Composables"
-
-trace_tags:
-  implements: "// @trace.implements={UC-ID}-SC{N}"
-  source: "// @trace.source=specs/{domain}/{prd-slug}/bdd/{platform}/{UC-ID}-{slug}.feature"

package/modules/angular/architecture-snippets/component-patterns.md

@@ -1,187 +0,0 @@
-# Angular — Component Architecture Patterns
-
-## Smart / Container Component Pattern
-
-```typescript
-// order-list.component.ts — Smart component: manages state, injects services
-import { Component, OnInit, inject } from '@angular/core';
-import { CommonModule } from '@angular/common';
-import { OrderService } from '../services/order.service';
-import { OrderListItemComponent } from './order-list-item.component';
-import { Order } from '../models/order.model';
-
-@Component({
-  selector: 'app-order-list',
-  standalone: true,
-  imports: [CommonModule, OrderListItemComponent],
-  template: `
-    <div class="order-list">
-      <app-order-list-item
-        *ngFor="let order of orders"
-        [order]="order"
-        (cancel)="onCancelOrder($event)"
-      />
-    </div>
-  `
-})
-export class OrderListComponent implements OnInit {
-  private orderService = inject(OrderService);
-  orders: Order[] = [];
-
-  ngOnInit(): void {
-    this.orderService.getOrders().subscribe(orders => this.orders = orders);
-  }
-
-  onCancelOrder(orderId: number): void {
-    this.orderService.cancelOrder(orderId).subscribe(() => {
-      this.orders = this.orders.filter(o => o.id !== orderId);
-    });
-  }
-}
-```
-
-## Dumb / Presentational Component Pattern
-
-```typescript
-// order-list-item.component.ts — Dumb component: pure I/O, OnPush, no service injection
-import { Component, Input, Output, EventEmitter, ChangeDetectionStrategy } from '@angular/core';
-import { Order } from '../models/order.model';
-
-@Component({
-  selector: 'app-order-list-item',
-  standalone: true,
-  changeDetection: ChangeDetectionStrategy.OnPush,
-  template: `
-    <div class="order-item">
-      <span>{{ order.id }}</span>
-      <span>{{ order.status }}</span>
-      <button (click)="cancel.emit(order.id)" [disabled]="order.status === 'CANCELLED'">
-        Cancel
-      </button>
-    </div>
-  `
-})
-export class OrderListItemComponent {
-  @Input({ required: true }) order!: Order;
-  @Output() cancel = new EventEmitter<number>();
-}
-```
-
-## Service with HttpClient Pattern
-
-```typescript
-// order.service.ts
-import { Injectable, inject } from '@angular/core';
-import { HttpClient, HttpParams } from '@angular/common/http';
-import { Observable } from 'rxjs';
-import { Order, CreateOrderRequest, OrderResponse } from '../models/order.model';
-import { environment } from '@env/environment';
-
-@Injectable({ providedIn: 'root' })
-export class OrderService {
-  private http = inject(HttpClient);
-  private baseUrl = `${environment.apiUrl}/v1/orders`;
-
-  getOrders(customerId?: number): Observable<Order[]> {
-    let params = new HttpParams();
-    if (customerId) params = params.set('customerId', customerId.toString());
-    return this.http.get<Order[]>(this.baseUrl, { params });
-  }
-
-  getOrder(id: number): Observable<Order> {
-    return this.http.get<Order>(`${this.baseUrl}/${id}`);
-  }
-
-  createOrder(request: CreateOrderRequest): Observable<OrderResponse> {
-    return this.http.post<OrderResponse>(this.baseUrl, request);
-  }
-
-  cancelOrder(id: number): Observable<void> {
-    return this.http.patch<void>(`${this.baseUrl}/${id}/cancel`, {});
-  }
-}
-```
-
-## Signal-Based State Pattern (Angular 17+)
-
-```typescript
-// order.store.ts — using Angular Signals for state management
-import { Injectable, signal, computed } from '@angular/core';
-import { Order } from '../models/order.model';
-
-@Injectable({ providedIn: 'root' })
-export class OrderStore {
-  private _orders = signal<Order[]>([]);
-  private _loading = signal(false);
-  private _error = signal<string | null>(null);
-
-  // Public readable signals
-  readonly orders = this._orders.asReadonly();
-  readonly loading = this._loading.asReadonly();
-  readonly error = this._error.asReadonly();
-
-  // Computed signals
-  readonly pendingOrders = computed(() =>
-    this._orders().filter(o => o.status === 'PENDING')
-  );
-  readonly orderCount = computed(() => this._orders().length);
-
-  setOrders(orders: Order[]): void {
-    this._orders.set(orders);
-  }
-
-  setLoading(loading: boolean): void {
-    this._loading.set(loading);
-  }
-
-  setError(error: string | null): void {
-    this._error.set(error);
-  }
-
-  removeOrder(id: number): void {
-    this._orders.update(orders => orders.filter(o => o.id !== id));
-  }
-}
-```
-
-## Route Guard Pattern
-
-```typescript
-// auth.guard.ts
-import { inject } from '@angular/core';
-import { CanActivateFn, Router } from '@angular/router';
-import { AuthService } from '../services/auth.service';
-
-export const authGuard: CanActivateFn = (route, state) => {
-  const auth = inject(AuthService);
-  const router = inject(Router);
-
-  if (auth.isAuthenticated()) {
-    return true;
-  }
-  return router.createUrlTree(['/login'], { queryParams: { returnUrl: state.url } });
-};
-```
-
-## Standalone Component with Lazy Loading
-
-```typescript
-// app.routes.ts
-import { Routes } from '@angular/router';
-import { authGuard } from './guards/auth.guard';
-
-export const APP_ROUTES: Routes = [
-  {
-    path: 'orders',
-    canActivate: [authGuard],
-    loadComponent: () =>
-      import('./features/orders/order-list.component').then(m => m.OrderListComponent)
-  },
-  {
-    path: 'orders/:id',
-    canActivate: [authGuard],
-    loadComponent: () =>
-      import('./features/orders/order-detail.component').then(m => m.OrderDetailComponent)
-  }
-];
-```

package/modules/angular/module.yaml

@@ -1,6 +0,0 @@
-name: "Angular"
-version: "1.0.0"
-description: "Angular 17+ frontend with component-based architecture"
-language: "TypeScript"
-framework: "Angular"
-stack_type: "frontend"

package/modules/angular/stack-profile.yaml

@@ -1,38 +0,0 @@
-build:
-  compile: "ng build"
-  test: "ng test --watch=false"
-  run: "ng serve"
-
-architecture:
-  style: "Component → Service → HTTP Client → Backend API"
-  key_rules:
-    - "Smart (container) components manage state and inject services"
-    - "Dumb (presentational) components receive data via @Input and emit via @Output"
-    - "Business logic lives in services, not in component classes"
-    - "Use OnPush change detection for all pure presentational components"
-    - "HTTP calls must be in services, never in component files"
-
-coding_standards:
-  naming:
-    components: "PascalCase + Component suffix (e.g., OrderListComponent)"
-    services: "PascalCase + Service suffix (e.g., OrderService)"
-    pipes: "PascalCase + Pipe suffix (e.g., CurrencyFormatPipe)"
-    directives: "PascalCase + Directive suffix (e.g., HighlightDirective)"
-    guards: "PascalCase + Guard suffix (e.g., AuthGuard)"
-    files:
-      component: "{feature}.component.ts / .html / .scss"
-      service: "{feature}.service.ts"
-      model: "{feature}.model.ts"
-      store: "{feature}.store.ts"
-  patterns:
-    state_management: "NgRx (complex) or Angular Signals (simple/medium)"
-    http_error_handling: "HttpInterceptor catches 4xx/5xx globally"
-    lazy_loading: "All feature modules must be lazily loaded"
-
-testing:
-  unit: "Jasmine + Karma or Jest"
-  e2e: "Cypress or Playwright"
-  patterns:
-    - "Use TestBed.configureTestingModule for component tests"
-    - "Mock services with jasmine.createSpyObj or jest.fn()"
-    - "Test component DOM via DebugElement and By.css selectors"

package/modules/context-engineering/architecture-snippets/context-design.md

@@ -1,119 +0,0 @@
-# Context Engineering — Design Templates and Patterns
-
-## System Context Design Template
-
-```markdown
-# System Context: {Agent Name}
-
-## Role
-You are {role description}. You help {target user} to {primary purpose}.
-
-## Scope
-In scope:
-- {capability 1}
-- {capability 2}
-
-Out of scope (do not attempt):
-- {excluded capability 1}
-- {excluded capability 2}
-
-## Output Format
-Always respond with:
-- {format requirement 1, e.g., "structured YAML when producing artifacts"}
-- {format requirement 2, e.g., "numbered steps for procedural instructions"}
-- {format requirement 3, e.g., "a CHECKPOINT before any destructive action"}
-
-## Constraints
-- {constraint 1, e.g., "Never make changes without explicit user confirmation"}
-- {constraint 2, e.g., "Always cite source files when referencing code"}
-
-## Tools Available
-- {tool name}: {what it does and when to use it}
-```
-
-## Context Layering: Persistent vs Ephemeral
-
-```
-┌─────────────────────────────────────────────────┐
-│  PERSISTENT (system prompt — stable, pre-loaded) │
-│  - Role and persona                              │
-│  - Output format requirements                    │
-│  - Constraint rules                              │
-│  - Domain knowledge (project context)            │
-└────────────────────┬────────────────────────────┘
-                     │ passed once at session start
-┌────────────────────▼────────────────────────────┐
-│  SESSION (loaded once per task)                  │
-│  - Project-context.yaml                          │
-│  - CLAUDE.md                                     │
-│  - Business dictionary                           │
-└────────────────────┬────────────────────────────┘
-                     │ loaded on demand
-┌────────────────────▼────────────────────────────┐
-│  EPHEMERAL (per-turn, discarded after use)       │
-│  - Tool results                                  │
-│  - File contents read mid-task                   │
-│  - User clarification answers                    │
-└─────────────────────────────────────────────────┘
-```
-
-## Context Handoff Between Agents
-
-When passing work from one agent to another, include a structured handoff payload:
-
-```yaml
-# Agent Handoff Payload
-handoff_from: "{source agent name}"
-handoff_to: "{target agent name}"
-task_id: "{unique task identifier}"
-status: "partial_complete"  # pending | partial_complete | blocked | ready_for_review
-
-# What was accomplished
-completed:
-  - "{step 1 done}"
-  - "{step 2 done}"
-
-# What the next agent must do
-pending:
-  - "{step 3 to do}"
-  - "{step 4 to do}"
-
-# Decisions made (so next agent doesn't re-litigate)
-decisions:
-  - decision: "{what was decided}"
-    rationale: "{why}"
-
-# Artifacts produced (file paths)
-artifacts:
-  - path: "{file path}"
-    type: "{type: spec | code | test | report}"
-    status: "{draft | approved | final}"
-
-# Context the next agent needs immediately
-context_snapshot:
-  project_name: "{name}"
-  domain: "{domain}"
-  uc_id: "{UC-ID}"
-  tech_stack: "{stack}"
-```
-
-## Context Compression Pattern
-
-When conversation history grows large, compress before the next turn:
-
-```
-CONTEXT SUMMARY (replaces N previous turns):
-Task: {what we are doing}
-Progress: {what has been completed so far}
-Current state: {where we are now}
-Key decisions: {decisions that must not be reversed}
-Pending: {what still needs to be done}
-Files produced: {list of artifact paths}
-```
-
-Compression rules:
-1. Keep all decisions and their rationale.
-2. Keep all file paths that were created.
-3. Drop intermediate reasoning that led to a confirmed decision.
-4. Keep any user corrections or explicit preferences.
-5. Keep any open questions that are still unresolved.

package/modules/context-engineering/module.yaml

@@ -1,9 +0,0 @@
-name: "Context Engineering"
-version: "1.0.0"
-description: "AI context design, prompt engineering, and system context workflows"
-stack_type: "ai-first"
-use_cases:
-  - "Designing AI system contexts"
-  - "Reverse engineering existing prompts"
-  - "Context window optimization"
-  - "Multi-agent coordination"