◆ Concept Design

About This Project

This repository is a concept-design framework experiment packaged as a static-site generator.

The generator is useful on its own, but its main purpose is educational: it shows how independent concepts can be composed by syncs, and it exposes the places where that architecture still needs stronger engineering.

What Concept Design Means Here

A concept is an independent unit of behavior. It owns its state, actions, and queries. It should be understandable without knowing the rest of the app.

Synchronizations compose concepts. A sync watches for actions in the engine journal, enriches frames with queries, and fires follow-up actions.

What The Example Site Does

This site explains the repo while being generated by the repo. It includes:

Why The Issues Are Published

The review found brittle places in path handling, build success, dev mode, engine matching, template parsing, and concept boundaries.

Publishing those findings in the example site makes the architecture honest. The site is not a brochure; it is a map of the implementation and the repair work ahead.

Start with This Repo in One Pass, or go directly to Issue Review.