Install
openclaw skills install @agenticweb4/software-concept-architect-guardrailsKeep Specs and Code Aligned
openclaw skills install @agenticweb4/software-concept-architect-guardrailsFocus: do existing specifications state module contracts clearly and correspond to facts and derived
maps? Run only on explicit $software-concept-architect-guardrails invocation. The workflow adapts
wyx v0.26.0 under MIT (LICENSE.upstream); specifications use
this repository's Jackson dialect while runtime scripts retain upstream behavior.
CONCEPT.md defines purpose, state, actions, and operational principle; optional notes hold
application context.SYNCS.md records app/include/sync coordination for application purposes and scenarios;
when/where/then define rules and // flow: groups them.PIPELINE.md records sources, stages, outputs, invariants, triggers, and data boundaries without
replacing synchronizations.ARCHITECTURE.md is a derived navigation map. Product dependencies come from the overall PRD, not
synchronization edges.Synchronization may restrict behavior, never extend the contract: flag violating coordination during backfill rather than legitimizing it. Coverage does not prove design correctness; accurate maps do not prove code conformance. Label inferred purposes; an ideal OP cannot justify a defect.
Use $software-concept-architect-guardrails <mode> [path-or-description]. A path means backfill, a description means
create, and no argument means discover candidates. Start with audit when the mode is absent or the
project has no specifications.
| Mode | Output and required reference |
|---|---|
audit | Read-only coverage and command plan: references/audit.md |
concept | Concept candidates or CONCEPT: references/concept.md |
drift | Read-only drift report: references/drift-detection.md |
pipeline | Pipeline candidates or PIPELINE: references/pipeline.md |
sync | Coordination candidates or SYNCS: references/sync.md |
map | Derived maps: references/map.md |
Route complex modeling to software-concept-architect-design, confirmed-model transcription to software-concept-architect-prd, and
fitness/independence/composition review to software-concept-architect-review.
references/spec-format.md for behavior, interfaces, and dialect compatibility.sync: sections for migration rather than mixing dialects. When authorized, rewrite
CONCEPT/SYNCS/PIPELINE together while preserving triggers, bindings, effects, and failure
semantics.Completion means the selected mode's definitions, relations, and references are evidenced; backfill
distinguishes facts, inference, and open decisions; reports name scan scope and repair direction;
maps are rebuilt from content rather than timestamps. For automatic injection read
references/hooks-runtime.md: hooks list specifications, flag staleness, and inject PIPELINE data
boundaries but do not validate semantic seams.