azcodr 1.2.2 → 1.3.0

package/AGENTS.md

@@ -100,7 +100,6 @@ To prevent context bloat and keep prompt overhead minimal, detailed engineering
 | **Relentless Questioning** | [docs/rules/relentless_questioning.md](./docs/rules/relentless_questioning.md) | Dynamic context-aware interrogation loops, adaptive decision trees. |
 | **Workspace Isolation** | [docs/rules/workspace_isolation.md](./docs/rules/workspace_isolation.md) | Strict workspace sovereignty, zero global contamination, local ground truth. |
 | **Continuous Learning** | [docs/rules/continuous_learning.md](./docs/rules/continuous_learning.md) | Direct rule ingestion, root-cause analysis, dynamic invariant updates. |
-| **Upstream Sync** | [docs/rules/upstream_synchronization.md](./docs/rules/upstream_synchronization.md) | Logging generic architecture improvements to changes.md; zero baseline pollution. |
 ---
 
 ## 4. Agent Configuration & Workspace Architecture

package/README.md

@@ -38,11 +38,10 @@
 ├── docs/
 │   ├── knowledge/                    # Institutional knowledge & domain contracts
 │   │   └── ubiquitous_language.md    # Living Ubiquitous Language glossary template
-│   └── rules/                        # 45 atomic single-responsibility domain rules
+│   └── rules/                        # 44 atomic single-responsibility domain rules
 ├── AGENTS.md                         # Lean root agentic configuration (< 120 lines)
 ├── CLAUDE.md -> AGENTS.md            # Filesystem symlink for harness parity
 ├── agents.md -> AGENTS.md            # Filesystem symlink for harness parity
-├── changes.md                        # Upstream changes ledger
 ├── memory.md                         # Master memory hub & Lightweight ADR ledger
 └── README.md                         # Project documentation
 ```
@@ -51,7 +50,7 @@
 
 ## 📋 Progressive Disclosure Rules Catalog (`docs/rules/`)
 
-The architecture enforces 45 atomic, single-responsibility domain rules. Read on demand to prevent prompt context bloat:
+The architecture enforces 44 atomic, single-responsibility domain rules. Read on demand to prevent prompt context bloat:
 
 | Domain | Rule Reference File | Key Focus & Invariants |
 |---|---|---|
@@ -99,7 +98,6 @@ The architecture enforces 45 atomic, single-responsibility domain rules. Read on
 | **Relentless Questioning** | [`relentless_questioning.md`](./docs/rules/relentless_questioning.md) | Dynamic context-aware interrogation loops, adaptive decision trees. |
 | **Workspace Isolation** | [`workspace_isolation.md`](./docs/rules/workspace_isolation.md) | Strict workspace sovereignty, zero global contamination, local ground truth. |
 | **Continuous Learning** | [`continuous_learning.md`](./docs/rules/continuous_learning.md) | Direct 4-step rule ingestion, root-cause analysis, dynamic invariant updates. |
-| **Upstream Sync** | [`upstream_synchronization.md`](./docs/rules/upstream_synchronization.md) | Logging generic architecture improvements to changes.md; zero baseline pollution. |
 
 ---
 
@@ -167,4 +165,3 @@ Once confirmed, the agent automatically executes:
 
 - 📖 **[Living Ubiquitous Language Glossary](./docs/knowledge/ubiquitous_language.md)**: Authoritative domain vocabulary contract.
 - 📜 **[Lightweight ADR Ledger](./memory.md)**: Formal Architectural Decision Records and governing rules.
-- 📝 **[Upstream Changes Ledger](./changes.md)**: Record candidate improvements and generic patterns for the upstream azcodr template.

package/bin/azcodr.js

@@ -4,7 +4,7 @@
 const path = require('node:path');
 const readline = require('node:readline');
 const fs = require('node:fs');
-const { scaffold, logChange, getTemplateDir } = require('../lib/scaffold.js');
+const { scaffold, getTemplateDir } = require('../lib/scaffold.js');
 const pkg = require('../package.json');
 
 function printHelp(out = console.log) {
@@ -14,13 +14,11 @@ Enterprise Multi-Tenant Architecture & Agentic Engineering Starter Template
 
 Usage:
   npx azcodr [directory] [options]
-  npx azcodr change <title> [options]
 
 Commands:
   [directory]     Scaffold azcodr template into directory (default: current directory)
-  change <title>  Log a generic architectural change to changes.md
 
-Scaffold Options:
+Options:
   -d, --dry-run   Simulate scaffolding without modifying filesystem
   -s, --silent    Suppress console output messages
   -f, --force     Overwrite existing files in target directory without confirmation
@@ -28,17 +26,10 @@ Scaffold Options:
   -v, --version   Display version number
   -h, --help      Display this help message
 
-Change Options:
-  -c, --category  Category (Architecture | Rule | Skill | Infrastructure | CLI | Knowledge Hub)
-  -f, --files     Target file(s) affected (e.g. "docs/rules/caching.md")
-  -r, --rationale Rationale for upstream template incorporation
-  -d, --desc      Detailed description of the change
-
 Examples:
   npx azcodr my-project
   npx azcodr . --dry-run
   npx azcodr . --force
-  npx azcodr change "Add Wasm plugin interface" -c Architecture
 `);
 }
 
@@ -67,70 +58,6 @@ function askQuestion(query, { input = process.stdin, output = process.stdout } =
   });
 }
 
-async function handleLogChange(rawArgs = process.argv.slice(2), io = {}) {
-  const {
-    out = console.log,
-    err = console.error,
-    exit = process.exit,
-    stdin = process.stdin,
-    stdout = process.stdout,
-    cwd = process.cwd(),
-    logChange: logChangeFn = logChange
-  } = io;
-
-  let title = null;
-  let category = 'Architecture';
-  let targetFiles = 'docs/rules/';
-  let rationale = 'Generic architectural enhancement';
-  let description = '';
-
-  for (let i = 1; i < rawArgs.length; i++) {
-    const a = rawArgs[i];
-    if (a === '-c' || a === '--category') {
-      category = rawArgs[++i] || category;
-    } else if (a === '-f' || a === '--files') {
-      targetFiles = rawArgs[++i] || targetFiles;
-    } else if (a === '-r' || a === '--rationale') {
-      rationale = rawArgs[++i] || rationale;
-    } else if (a === '-d' || a === '--desc' || a === '--description') {
-      description = rawArgs[++i] || description;
-    } else if (a.startsWith('-')) {
-      err(`❌ Error: Unknown argument '${a}'. Run 'npx azcodr --help' for available options.`);
-      return exit(1);
-    } else if (!title) {
-      title = a;
-    }
-  }
-
-  if (!title) {
-    if (stdin.isTTY) {
-      title = await askQuestion('? Change title: ', { input: stdin, output: stdout });
-    }
-  }
-
-  if (!title) {
-    err('❌ Error: A title is required to log an upstream change.');
-    err('Usage: npx azcodr change "<title>" [-c Category] [-f Files] [-r Rationale] [-d Description]');
-    return exit(1);
-  }
-
-  try {
-    const res = logChangeFn({
-      title,
-      category,
-      targetFiles,
-      rationale,
-      description,
-      targetDir: cwd
-    });
-    out(`\n✅ Upstream change logged to ${res.filePath}\n`);
-    return exit(0);
-  } catch (error) {
-    err(`\n❌ Failed to log change: ${error.message}\n`);
-    return exit(1);
-  }
-}
-
 async function runCli(rawArgs = process.argv.slice(2), io = {}) {
   const {
     out = console.log,
@@ -143,10 +70,6 @@ async function runCli(rawArgs = process.argv.slice(2), io = {}) {
     scaffold: scaffoldFn = scaffold
   } = io;
 
-  if (rawArgs[0] === 'change' || rawArgs[0] === 'log-change') {
-    return handleLogChange(rawArgs, io);
-  }
-
   let targetDir = null;
   let force = false;
   let noGit = false;
@@ -257,7 +180,6 @@ async function runCli(rawArgs = process.argv.slice(2), io = {}) {
       out('  ✅ Progressive disclosure rules copied (docs/rules/)');
       out('  ✅ Workspace knowledge hub and ADR ledger copied (docs/knowledge/, memory.md)');
       out('  ✅ Specialized agentic skills copied (.agents/skills/)');
-      out('  ✅ Upstream changes ledger initialized (changes.md)');
       out('  ✅ Editor formatting standards initialized (.editorconfig)');
       out('  ✅ Agent directives and harness symlinks established (AGENTS.md, CLAUDE.md, agents.md)');
       if (result.gitInitialized) {
@@ -294,7 +216,6 @@ if (require.main === module) {
 
 module.exports = {
   runCli,
-  handleLogChange,
   askQuestion,
   printHelp,
   printVersion,

package/docs/knowledge/ubiquitous_language.md

@@ -8,12 +8,7 @@
 
 | Canonical Term | Business Definition | Bounded Context | Forbidden Synonyms | Code & Database Identifiers |
 |---|---|---|---|---|
-| **Organization** | The top-level administrative and multi-tenant isolation container. | Multi-Tenancy & Identity | Account, Company, Workspace, TenantGroup | `Organization`, `organizationId`, `organizations` table |
-| **User** | A human actor authenticated with verified credentials across the platform. | Identity & Access | Member (when unauthenticated), Account, Login | `User`, `userId`, `users` table |
-| **Membership** | The formal association connecting a User to an Organization with assigned roles. | Authorization & RBAC | UserOrg, Seat, PermissionAssignment | `Membership`, `membershipId`, `memberships` table |
-| **Role** | A named set of granular `<entity>:<action>` permissions within an organization. | Authorization | Group, Profile, Level | `Role`, `roleId`, `roles` table |
-| **Resource** | The primary business entity managed within the domain core. | Core Domain | Item, Object, Record, Entity | `Resource`, `resourceId`, `resources` table |
-| **Ledger Entry** | An immutable audit record detailing a financial or transactional state change. | Finance & Accounting | TransactionRow, MoneyLog, BillEntry | `LedgerEntry`, `ledgerEntryId`, `ledger_entries` table |
+| *(No domain terms defined yet)* | *Define business meaning during Phase 1 Domain Discovery.* | *e.g. Core Domain* | *Synonyms strictly forbidden across code & UI.* | *Exact type, class, or table name.* |
 
 ---
 

package/lib/index.d.ts

@@ -31,30 +31,6 @@ export interface ScaffoldResult {
   actions: string[];
 }
 
-export interface LogChangeOptions {
-  /** Short title describing the architectural change */
-  title: string;
-  /** Category of change (Architecture | Rule | Skill | Infrastructure | CLI | Knowledge Hub) */
-  category?: string;
-  /** Target file(s) affected by the change */
-  targetFiles?: string;
-  /** Architectural rationale for upstream template incorporation */
-  rationale?: string;
-  /** Detailed description of the change */
-  description?: string;
-  /** Working directory containing changes.md (default: process.cwd()) */
-  targetDir?: string;
-}
-
-export interface LogChangeResult {
-  /** Whether the log entry was successfully recorded */
-  success: boolean;
-  /** Absolute path to changes.md */
-  filePath: string;
-  /** Markdown entry text that was appended */
-  entry: string;
-}
-
 export interface ValidateTargetOptions {
   /** Custom template root directory */
   templateDir?: string;
@@ -79,11 +55,6 @@ export interface CopyTemplateOptions {
  */
 export function scaffold(options?: ScaffoldOptions): ScaffoldResult;
 
-/**
- * Appends a standardized upstream change entry to changes.md.
- */
-export function logChange(options: LogChangeOptions): LogChangeResult;
-
 /**
  * Validates the target directory to ensure it is suitable for scaffolding.
  */
@@ -139,7 +110,6 @@ export const TEMPLATE_ITEMS: readonly string[];
 
 declare const defaultExport: {
   scaffold: typeof scaffold;
-  logChange: typeof logChange;
   validateTarget: typeof validateTarget;
   copyTemplate: typeof copyTemplate;
   ensureSymlink: typeof ensureSymlink;

package/lib/scaffold.js

@@ -7,7 +7,6 @@ const cp = require('node:child_process');
 const TEMPLATE_ITEMS = [
   'AGENTS.md',
   'memory.md',
-  'changes.md',
   'README.md',
   'docs',
   '.agents',
@@ -227,53 +226,8 @@ function scaffold(options = {}) {
   };
 }
 
-/**
- * Appends a standardized upstream change entry to changes.md.
- */
-function logChange(options = {}) {
-  const {
-    title,
-    category = 'Architecture',
-    targetFiles = 'docs/rules/',
-    rationale = 'Generic architectural enhancement',
-    description = '',
-    targetDir = process.cwd()
-  } = options;
-
-  if (!title || typeof title !== 'string' || !title.trim()) {
-    throw new Error('A change title is required to log an upstream change.');
-  }
-
-  const cleanTitle = title.trim();
-  const changesFilePath = path.join(path.resolve(targetDir), 'changes.md');
-  const today = new Date().toISOString().slice(0, 10);
-
-  const entry = `\n### [${today}] ${cleanTitle}\n` +
-    `- **Category:** ${category}\n` +
-    `- **Target File(s):** ${targetFiles}\n` +
-    `- **Rationale:** ${rationale}\n` +
-    `- **Description:** ${description || cleanTitle}\n` +
-    `- **Domain Filter Verification:** Verified 100% generic; purged of all project-specific business entities and models.\n`;
-
-  if (fs.existsSync(changesFilePath)) {
-    fs.appendFileSync(changesFilePath, entry, 'utf-8');
-  } else {
-    const initialHeader = `# Upstream Changes Ledger (\`changes.md\`)\n\n` +
-      `> **Core Purpose:** Record candidate improvements, generic architectural updates, defect post-mortems, and rule enhancements discovered in this workspace that should be incorporated into the upstream \`azcodr\` baseline template.\n\n` +
-      `---\n\n## Upstream Changes Log\n`;
-    fs.writeFileSync(changesFilePath, initialHeader + entry, 'utf-8');
-  }
-
-  return {
-    success: true,
-    filePath: changesFilePath,
-    entry
-  };
-}
-
 module.exports = {
   scaffold,
-  logChange,
   validateTarget,
   copyTemplate,
   ensureSymlink,

package/memory.md

@@ -8,7 +8,6 @@
 
 - 📖 **[Living Ubiquitous Language Glossary](./docs/knowledge/ubiquitous_language.md)**: Authoritative, single-name domain vocabulary contract.
 - 📜 **[Lightweight ADR Master Index](#adr-master-index)**: Summary of all architectural decisions and direct links to governing rules.
-- 📝 **[Upstream Changes Ledger](./changes.md)**: Ledger of candidate improvements and generic patterns for upstream azcodr.
 
 ---
 
@@ -34,6 +33,7 @@
 | **ADR-015** | Problem-First Architecture, Topology Scaffolding, Tipping Points & Nano-TDD | 2026-09-25 | ACCEPTED | [`clean_code.md`](./docs/rules/clean_code.md), [`domain_driven_design.md`](./docs/rules/domain_driven_design.md), [`test_driven_development.md`](./docs/rules/test_driven_development.md), [`lets-build`](./.agents/skills/lets-build/SKILL.md) |
 | **ADR-016** | Elimination of Static Markdown Knowledge Graph | 2026-09-25 | ACCEPTED | [`clean_code.md`](./docs/rules/clean_code.md), [`continuous_learning.md`](./docs/rules/continuous_learning.md) |
 | **ADR-017** | Progressive Rules Consolidation (DDD & GoF Patterns) | 2026-09-25 | ACCEPTED | [`domain_driven_design.md`](./docs/rules/domain_driven_design.md), [`design_patterns.md`](./docs/rules/design_patterns.md) |
+| **ADR-018** | Elimination of Upstream Changes Ledger and Sync Tooling | 2026-09-25 | ACCEPTED | [`clean_code.md`](./docs/rules/clean_code.md), [`workspace_isolation.md`](./docs/rules/workspace_isolation.md) |
 
 
 ---
@@ -143,3 +143,13 @@
   3. Streamline rule catalog across `AGENTS.md` and `README.md` to 45 lean, single-responsibility, non-overlapping rules.
 - **Enforced In:** [`AGENTS.md`](./AGENTS.md), [`README.md`](./README.md), [`domain_driven_design.md`](./docs/rules/domain_driven_design.md), [`design_patterns.md`](./docs/rules/design_patterns.md).
 
+#### ADR-018: Elimination of Upstream Changes Ledger and Upstream Sync Tooling
+- **Date:** 2026-09-25 | **Status:** ACCEPTED
+- **Context:** Maintaining a manual `changes.md` ledger duplicated state already captured across Git commit history and formal ADR records in `memory.md`. Furthermore, scaffolding `changes.md` into downstream derived projects contaminated them with meta-tooling baggage about the upstream template, violating Problem-First Architecture and Workspace Sovereignty. Accompanying CLI subcommands (`npx azcodr change`) and rule files (`upstream_synchronization.md`) added over 200 lines of accidental maintenance complexity.
+- **Decision:**
+  1. Permanently delete `changes.md` and retire `docs/rules/upstream_synchronization.md`.
+  2. Remove `changes.md` from scaffolded `TEMPLATE_ITEMS` and package manifests.
+  3. Purge `logChange` functions, types, and CLI subcommands, restoring `azcodr` CLI as a clean, single-purpose project bootstrapper.
+  4. Standardize exclusively on Git commits for historical revision logs and `memory.md` for architectural decision records.
+- **Enforced In:** [`AGENTS.md`](./AGENTS.md), [`README.md`](./README.md), [`lib/scaffold.js`](./lib/scaffold.js), [`bin/azcodr.js`](./bin/azcodr.js), [`memory.md`](./memory.md).
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azcodr",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "description": "Enterprise Architecture & Agentic Engineering Starter Template",
   "bin": {
     "azcodr": "bin/azcodr.js"
@@ -19,7 +19,6 @@
     "lib",
     "AGENTS.md",
     "memory.md",
-    "changes.md",
     "README.md",
     "docs",
     ".agents",

package/changes.md

@@ -1,79 +0,0 @@
-# Upstream Changes Ledger (`changes.md`)
-
-> **Core Purpose:** Record candidate improvements, generic architectural updates, defect post-mortems, and rule enhancements discovered in this workspace that should be incorporated into the upstream `azcodr` baseline template. No automated git merging or external repo mutation is performed.
-
----
-
-## 1. Specification & Protocol
-
-When an AI agent or engineer discovers a generic architectural improvement, bug fix, or rule refinement during project development, append an entry below using this atomic format:
-
-```markdown
-### [YYYY-MM-DD] <Title of Change>
-- **Category:** Rule | Skill | Infrastructure | CLI | Knowledge Hub
-- **Target File(s):** `docs/rules/...`, `.agents/skills/...`, etc.
-- **Rationale:** Why this improvement is necessary or valuable across all enterprise projects.
-- **Description:** Concise summary of the mutation or invariant added.
-- **Domain Filter Verification:** Verified 100% generic; purged of all project-specific business entities and models.
-```
-
----
-
-## 2. Upstream Changes Log
-
-### [2026-09-25] Initialized npx Scaffolder CLI and npm Package
-- **Category:** CLI & Infrastructure
-- **Target File(s):** `bin/azcodr.js`, `lib/scaffold.js`, `package.json`, `tests/`
-- **Rationale:** Eliminate manual `cp -r` copying; enable anyone to pull and scaffold the azcodr architecture template via `npx azcodr`.
-- **Description:** Implemented zero-dependency Node.js CLI executable with Outside-In TDD, harness parity symlink generation, script execution bit setting, and full test suite passing with 100% agentic config validation.
-- **Domain Filter Verification:** Verified 100% generic; no project-specific business models.
-
-### [2026-09-25] Streamlined Upstream Sync Protocol to changes.md Ledger
-- **Category:** Rule & Process
-- **Target File(s):** `docs/rules/upstream_synchronization.md`, `changes.md`, `AGENTS.md`
-- **Rationale:** Remove fragile git repo resolution and merge scripts; replace with atomic change logging in `changes.md`.
-- **Description:** Retired `merge-ai` skill and removed machine-specific hardcoded paths. All upstream improvements are now recorded atomically in `changes.md`.
-- **Domain Filter Verification:** Verified 100% generic.
-
-### [2026-09-25] Harden CLI, achieve 100% test coverage gates, add multi-OS CI workflow, and TypeScript declarations
-- **Category:** CLI
-- **Target File(s):** bin/azcodr.js, lib/scaffold.js, lib/index.d.ts, .github/workflows/ci.yml
-- **Rationale:** Fulfill 100.00% test coverage mandate, cross-platform CI matrix, and library type safety
-- **Description:** Remediate gap assessment findings: add --dry-run and --silent flags, enforce 100.00% line/branch/function coverage gates, add GitHub Actions CI matrix across Node 18/20/22/24 and Linux/macOS/Windows, add .editorconfig template item, and export ambient TypeScript typings.
-- **Domain Filter Verification:** Verified 100% generic; purged of all project-specific business entities and models.
-
-### [2026-09-25] Resolve macOS/Windows Git Case-Collision and Cross-Version CI Matrix Coverage
-- **Category:** Infrastructure & CI
-- **Target File(s):** .gitignore, lib/scaffold.js, scripts/test_coverage.js, validate_agentic_configs.sh
-- **Rationale:** Ensure flawless cross-platform and multi-version Node execution across macOS, Windows, and Linux on Node 18, 20, 22, 24.
-- **Description:** Untracked agents.md from Git to prevent cyclic symlink overwrite on case-insensitive filesystems; hardened ensureSymlink with isSameCaseInsensitiveFile check; added cross-version test coverage runner script; updated npm test runner to use native discovery.
-- **Domain Filter Verification:** Verified 100% generic; purged of all project-specific business entities and models.
-
-### [2026-09-25] Problem-First Architecture, Evolutionary Tipping Points, and Incremental Nano-Cycle TDD
-- **Category:** Architecture, Rule & Skill
-- **Target File(s):** `AGENTS.md`, `docs/rules/clean_code.md`, `docs/rules/domain_driven_design.md`, `docs/rules/test_driven_development.md`, `.agents/skills/lets-build/SKILL.md`, `.agents/skills/lets-build/references/architecture_interview_matrix.md`, `.agents/skills/lets-build/scripts/bootstrap_workspace.sh`, `memory.md`
-- **Rationale:** Eliminate tool-first bias ("Solution-in-Search-of-a-Problem"), stop accidental complexity (as seen in `force-dark-light` where Chrome extension received Kubernetes and OpenAPI specs), prevent AI-accelerated architectural drift, and halt the "Test-First Waterfall" batch-test anti-pattern.
-- **Description:** 
-  1. Enforced Problem Space vs Solution Space decoupling with zero tool bias.
-  2. Made scaffolding strictly topology-aware (Web SaaS, Browser Extension, Game/Engine, CLI, Library) with zero speculative bloat.
-  3. Codified Evolutionary Architecture, the 5 Architectural Tipping Points, and Kent Beck's "Refactor-Before-Add" protocol.
-  4. Codified Uncle Bob's Three Laws of TDD, banned batch-test dumps, and introduced the Incremental Nano-Cycle and Ping-Pong Pair Programming protocol.
-- **Domain Filter Verification:** Verified 100% generic; applicable across any language, stack, and project topology.
-
-### [2026-09-25] Permanent Removal of Static Markdown Knowledge Graph
-- **Category:** Architecture & Knowledge Hub
-- **Target File(s):** `docs/knowledge/knowledge_graph.md`, `AGENTS.md`, `memory.md`, `README.md`, `docs/rules/continuous_learning.md`
-- **Rationale:** Static markdown Mermaid diagrams and entity models in template repositories suffer from maintenance drift, duplicate state from code/migrations, violate Problem-First by assuming a multi-tenant web backend, and waste prompt token budget.
-- **Description:** Permanently eliminated `docs/knowledge/knowledge_graph.md`. Enforced code, type definitions, and versioned database migrations as the single source of truth for architectural topologies. Retained `docs/knowledge/ubiquitous_language.md` for lightweight living domain vocabulary contracts.
-- **Domain Filter Verification:** Verified 100% generic; purged of all speculative and duplicate static models.
-
-### [2026-09-25] Workspace Rules Consolidation & Redundancy Purge
-- **Category:** Rule & Knowledge Hub
-- **Target File(s):** `docs/rules/domain_driven_design.md`, `docs/rules/design_patterns.md`, `docs/rules/domain_expertise.md`, `docs/rules/gof_design_patterns_reference.md`, `AGENTS.md`, `README.md`, `memory.md`
-- **Rationale:** Eliminate duplicate and fragmented rules to optimize agent attention window, consolidate domain invariants, and uphold strict Single Responsibility across progressive disclosure documentation.
-- **Description:** 
-  1. Merged business capability mapping and Aggregate Root gatekeeper invariants from `domain_expertise.md` directly into `domain_driven_design.md`. Removed redundant `domain_expertise.md`.
-  2. Integrated the complete 23 Gang of Four patterns catalog from `gof_design_patterns_reference.md` directly into `design_patterns.md`. Removed redundant `gof_design_patterns_reference.md`.
-  3. Reduced active progressive disclosure rules from 47 to 45 while preserving 100% domain coverage.
-- **Domain Filter Verification:** Verified 100% generic; purged of all redundant files and circular links.
-

package/docs/rules/upstream_synchronization.md

@@ -1,53 +0,0 @@
-# Upstream Baseline Synchronization & changes.md Ledger
-
-> **Core Mandate:** Upstream template/baseline workspaces (`azcodr`) must remain strictly untouched during project development. When generic architectural improvements, rule refinements, or post-mortems are identified, record them solely into the `changes.md` ledger with zero automated repo merging or baseline contamination.
-
----
-
-## 1. The Baseline-Project Decoupling Principle
-
-Workspaces operate under a clean, decoupled flow:
-
-```
-[Upstream Generic Baseline: azcodr]
-               │
-               ▼  (Scaffolded via npx azcodr)
-[Derived Project Workspace: my-app / others]
-               │
-               │  (Accumulates project code, specificities, and institutional lessons)
-               │
-               ▼  (Record reusable improvements)
-[Upstream Changes Ledger: changes.md]
-```
-
-- **Pristine Upstream Mandate:** Never edit, commit, or attempt automated git merges to an upstream baseline repository during routine project development, feature implementation, or bug fixes.
-- **Ledger-Only Synchronization:** When generic architectural discoveries or defect post-mortems occur, document them cleanly in `changes.md` at the workspace root. No automated merge AI or remote repo synchronization is executed.
-
----
-
-## 2. Zero-Contamination Invariant (Generic vs. Specific)
-
-When logging proposed changes into `changes.md`, enforce strict domain filtering:
-
-| Element Category | Keep in Specific Project Workspace | Allow in changes.md for Upstream (`azcodr`) |
-|---|---|---|
-| **Domain Entities** | Concrete business models (`Order`, `Customer`, `Invoice`, etc.) | Abstract archetypes (`Entity`, `Aggregate`, `ValueObject`, `Resource`) |
-| **Tech Stack / Adapters** | Concrete choices (Prisma, SQLite dev, PostgreSQL prod, Vite React) | Hexagonal Ports, abstract repository contracts, polyglot adapter guidance |
-| **Architectural Rules** | Specific entity validation, specific route paths | Universal invariants (5-Phase Agile Lifecycle, SemVer trigger matrix, FK dropdowns) |
-| **ADRs** | Stack decisions (`ADR-006: Target Tech Stack for Project`) | Generic architecture patterns (`ADR-007` to `ADR-010`) |
-| **Test Suites** | Concrete domain tests (`order_domain.test.ts`, domain-specific suites) | Boundary smoke test pattern (`scripts/smoke_test.sh`), 100% coverage gate |
-
----
-
-## 3. Atomic changes.md Entry Protocol
-
-Every upstream-bound proposal logged to `changes.md` must follow the standardized format:
-
-```markdown
-### [YYYY-MM-DD] <Title of Change>
-- **Category:** Rule | Skill | Infrastructure | CLI | Knowledge Hub
-- **Target File(s):** `docs/rules/...`, `.agents/skills/...`, etc.
-- **Rationale:** Why this improvement is necessary or valuable across all enterprise projects.
-- **Description:** Concise summary of the mutation or invariant added.
-- **Domain Filter Verification:** Verified 100% generic; purged of all project-specific business entities and models.
-```