Skip to content

kfkchau/logic-atlas

Repository files navigation

🧠 Logic Atlas Framework

Logic Atlas is a modular, interoperable framework for modeling complex systems, activities, relationships, and enforcement logic. It is designed to support structured reasoning, tagging, simulation, and diagnostics across digital, policy, and operational domains.


📌 What Is Logic Atlas?

Logic Atlas is built from seven core sub-frameworks, each covering a distinct dimension of logic:

Framework Domain Core Dimensions Purpose
Activity Relationship Framework Activity Modeling Actor, Action, Object, Target Structuring agency and directionality
Action Classification Framework Action Tagging Movement × Transformation Tagging verbs/actions in workflows
Resource Typology Framework Resource Classification Consumability × Physicality Tagging and planning resource types
Enforcement Logic Framework Enforcement Modeling Scope × Mechanism + Source + Strength Modeling requirement enforcement
Quantification Schema Framework Universal Measurement Length × Width × Height Measuring entities, activities, flows
Relationship Architecture Framework Structural Mapping Hierarchical × Network × System Mapping influence and flow
Relational Geometry Framework Spatial Relationships Unrelated, Adjacent, Intersecting, Nested, Embedded Diagnosing entity proximity

All frameworks are MECE-aligned, interoperable, and designed for composability.


🚀 Getting Started

To begin using Logic Atlas:

  1. Explore the sub-frameworks — Each is documented in its own formal .md file.
  2. Use tagging logic — Apply movement, transformation, and quantification tags to actions and resources.
  3. Model activities — Use the Activity Relationship Framework to structure Actor → Action → Object → Target chains.
  4. Apply enforcement — Use the Enforcement Logic Framework to define rules, consequences, and escalation logic.
  5. Use spatial reasoning — Apply the Relational Geometry Framework to diagnose containment, adjacency, and overlap.

🔗 Integration Map

Logic Atlas frameworks are designed to interconnect. For example:

  • The Activity Relationship Framework consumes tags from the Action Classification, Resource Typology, and Quantification Schema frameworks.
  • The Enforcement Logic Framework links condition and outcome activities from the activity framework.
  • The Relational Geometry Framework overlays spatial logic on resources and activities.
  • The Relationship Architecture Framework defines the architecture of flows between entities.

See Meta-Framework Overview (logic-atlas-meta.md) for full integration logic.


📄 License

This work is part of the Logic Atlas system and is licensed under the Creative Commons Attribution 4.0 International License (CC BY 4.0).

“Based on work from the Logic Atlas system by Kelvin Chau, licensed under CC BY 4.0. Available at: https://github.com/kfkchau/logic-atlas”

To view the full license terms, see ./LICENSE.md


🧾 Reference & Attribution

© Kelvin Chau, 2025
This work is part of the Logic Atlas Framework.
For attribution, citation, or inquiries, please refer to:
🔗 https://au.linkedin.com/in/kfkchau


📚 Documentation Layers

  • logic-atlas-meta.md — Meta-framework logic and integration schema
  • logic-atlas-plan.md — Documentation strategy and governance
  • logic-atlas-glossary.md — Shared definitions and tag meanings
  • logic-atlas-changelog.md — Update history across all frameworks

🧪 Example Use Cases

  • Policy compliance modeling
  • Digital sourcing lifecycle analysis
  • Spatial diagnostics of resource flows
  • Enforcement chain simulation
  • Activity tagging and workflow mapping

📊 Benchmarking

Logic Atlas has been benchmarked against leading modeling and architecture frameworks including TOGAF, BPMN, ArchiMate, UML, and OPA. It stands out for its MECE enforcement, quantification schema, spatial reasoning, and governance structure.

Compared Frameworks

  • TOGAF – The Open Group Architecture Framework
  • Zachman Framework
  • BPMN – Business Process Model and Notation
  • ArchiMate
  • UML – Unified Modeling Language
  • OPA – Open Policy Agent

Benchmark Comparison Table

Dimension Logic Atlas TOGAF BPMN ArchiMate OPA UML
Modularity ✅ Fully modular sub-frameworks Partial Partial Partial
MECE Compliance ✅ Explicitly enforced
Tagging System ✅ Verb, resource, spatial, enforcement tags
Quantification Logic ✅ Length × Width × Height
Spatial Reasoning ✅ Venn 2.0 logic
Enforcement Modeling ✅ Scope × Mechanism × Source × Strength
Activity Structure ✅ Actor → Action → Object → Target Partial Partial Partial
Integration Schema ✅ Explicit matrix and meta-framework Partial Partial

See ./logic-atlas-benchmark.md for the full comparison table and analysis.


🛠️ Contributions

Logic Atlas is designed to be extensible. New frameworks, tags, and logic modules can be added using the standard sub-framework format defined in logic-atlas-plan.md.


⚠️ Disclaimer

The Logic Atlas framework and its documentation were developed with the assistance of AI tools. While the structure, logic, and content have been carefully designed, some sections may contain errors, inconsistencies, or incomplete logic due to limited manual review.

This release is intended as a working draft and will continue to evolve. Contributions, corrections, and feedback are welcome.

Please treat this version as preliminary and not yet production-certified.


© Kelvin Chau, 2025
This work is part of the Logic Atlas Framework.
For attribution, citation, or inquiries, please refer to:
🔗 https://au.linkedin.com/in/kfkchau

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published