Architecture drift review

Skill Karthick-Ramachandran/persist-os/.agents/skills/architecture-drift-review

Local-first CLI that gives your repo durable, AI-ready memory - features, ADRs, modules, architecture, standards & tests and a deterministic doctor that validates health, evidence & drift.

Install

npx -y skills add Karthick-Ramachandran/persist-os --skill architecture-drift-review

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

8 stars8 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.1 KB, as published. Nobody here has run it

Skill: Architecture Drift Review

Purpose

Find changes that diverge from accepted repository memory.

Drift is not difference from a Persist OS recommendation. Persist OS is architecture-neutral.

Inputs

Change summary or diff.
Feature docs.
Module docs.
ADRs.
Test results.

Required Reading

docs/10-architecture/ARCHITECTURE.md
docs/60-engineering/ENGINEERING_STANDARDS.md
docs/20-security/SECURITY_MODEL.md
Relevant docs/30-modules/<module>/MODULE.md
Relevant docs/40-features/<feature>/PRD.md
Relevant docs/adrs/*.md

Output Files

Relevant feature REVIEW.md
Relevant feature COMPLETION_REPORT.md
Updated docs only when the human accepts documented evolution.

Process

Review the change and identify changed modules and generated outputs.
Compare changes against accepted ADRs and repository decisions.
Compare changes against module boundaries.
Check for new dependencies and security-sensitive changes.
Check whether tests and docs were updated.
Classify findings.

Finding Types

Architecture drift
Dependency drift
Module drift
Security drift
Testing drift
Documentation drift
Engineering standards drift
Acceptable documented evolution

Stop Conditions

Stop and request human decision if:

An accepted ADR conflicts with the implementation.
The implementation conflicts with engineering standards.
A dependency was added without ADR consideration.
Authentication, authorization, storage, networking, secrets, telemetry, cloud, runtime MCP, or file write behavior changed without security review.
Feature behavior changed without a PRD or change request update.

Quality Bar

Findings distinguish drift from documented evolution.
Findings compare against accepted repository memory, not Persist OS preferences.
Each blocker names the missing source-of-truth update.
Review output is concrete enough to act on.