KB-3650 rev 2

README — laws-new Modular Architecture Rewrite Track

3 min read Revision 2
laws-newmodular-architecturessotdraft-trackconstitution-v4.7

README — knowledge/dev/laws-new/

Purpose

knowledge/dev/laws-new/ is the working folder for the modular architecture rewrite track.

This folder is used to draft the next-generation governance/law architecture for Incomex with the goal of making development faster, safer, and more modular.

The target direction is:

  • hard kernel, soft modules;
  • explicit module contracts;
  • isolated module sandboxes;
  • federated registry instead of one overloaded global registry;
  • promotion lanes based on blast radius;
  • faster feature development without weakening production/kernel safety.

SSOT rule for this rewrite track

If the same document exists in both:

  • knowledge/dev/laws/
  • knowledge/dev/laws-new/

then the document under knowledge/dev/laws-new/ is the SSOT for the modular architecture rewrite track.

The old document under knowledge/dev/laws/ remains the historical/enacted baseline until a separate enactment process formally promotes the new version.

Filename rule

When rewriting an existing law, keep the same filename where practical to make comparison easy.

Examples:

  • Old baseline: knowledge/dev/laws/constitution.md
  • New draft: knowledge/dev/laws-new/constitution.md

New architecture documents that do not exist in the old folder may be created only under knowledge/dev/laws-new/.

Safety boundary

This folder is a draft workspace.

Creating or editing documents here does not mean enactment.

No production mutation, production DDL, production deployment, approval mutation, registry mutation, or old-law rewrite is authorized by this README.

Expected initial outputs

The first modular architecture survey/draft pass should create at least:

  1. knowledge/dev/laws-new/architecture-survey.md
  2. knowledge/dev/laws-new/modular-architecture-proposal.md
  3. knowledge/dev/laws-new/constitution.md
  4. knowledge/dev/laws-new/migration-map.md
  5. knowledge/dev/laws-new/module-contract-standard.md

Draft status

All documents in this folder are DRAFT unless explicitly promoted by a separate enactment process.