arkweb-design-alignment

To align ArkWeb design with code, this skill extracts and compares requirement, design, spec, and analysis documents against repository implementations. It generates a mismatch list and uses one-diff-at-a-time user decisions to drive iterative rewrites or code rework until alignment is closed.

Design alignment is the process of detecting and enumerating all mismatches between requirement documents and actual code. It validates implementation by reading design artifacts, grepping real code signatures, and processing user decisions to rewrite designs or rework code with regression checks.

You can review code diffs by providing requirement.md and design.md paths along with the code directory. The skill performs structured extraction, compares them against repository implementation, and presents mismatches one at a time for you to accept, rework, or shelve.

Yes, design alignment supports optional spec.md and analysis.md documents alongside mandatory requirement and design files. It performs three-way information comparison by structuring all provided artifacts and validating them against the actual codebase.

When you accept an implementation mismatch during diff review, the skill automatically rewrites the original design document sections in-place to match the code. If you request rework instead, it triggers a coder and reviewer loop with regression checks.

Iterative remediation is needed during ArkWeb feature delivery when requirement, design, or spec documents diverge from repository code. It systematically processes each mismatch one at a time, ensuring every difference is either accepted, reworked, or shelved with an alignment summary.