agentsclimarketplace

Architectural review

Skill pngdeity/apm-user-repository/packages/architectural-review/.apm/skills/architectural-review

Personal APM marketplace — skills, prompts, agents, and instructions for AI coding agents

Install
npx -y skills add pngdeity/apm-user-repository --skill architectural-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

  • 0 stars0 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.

What its author says it does

Copied from the file, not written here

Workflow for writing and auditing Architecture Decision Records (ADR) and Technical Design Documents (TDD). Use when creating new architectural decisions or reviewing functional designs for correctness and logic. Not for modifying existing skills, performing code reviews, or implementing code changes.

SKILL.md

2.8 KB, as published. Nobody here has run it

Architectural Review Skill

This skill enforces high-fidelity architectural and technical documentation standards. It provides a structured workflow for drafting and auditing ADRs and TDDs.

Workflow: Drafting Documentation

When tasked with writing an ADR or TDD, follow the schemas defined in references/schemas.md.

  1. Information Gathering: Identify all "Decision Drivers" and "Alternatives Considered."
  2. Drafting: Use imperative mood and scannable tables/bullets.
  3. Verification: Ensure mandatory sections (like "Alternatives Considered" for ADRs) are present.

Workflow: The 3-Phase Audit

When tasked with reviewing an existing document, perform this exhaustive audit:

Phase 1: Structural Audit

  • Checklist: Verify all required sections from references/schemas.md are present.
  • Grading: Mark as [Fail] if the "Alternatives Considered" section is missing or if the "Interface Contract" lacks strict types.
    • If structural audit fails: Stop and report the missing sections. Do not proceed to Phase 2 until the document structure is corrected.

Phase 2: Logic & Soundness Audit

  • Blast Radius: Evaluate the impact of the decision on other system components.
  • Complexity: Identify potential "Gold Plating" or over-engineering.
  • Security: Check for "Fail Securely" violations and PII leakage.
  • Pure Function Test (TDD Only): Verify if the module is truly atomic and side-effect-free.

Phase 3: Consistency Report

  • Lineage: Ensure the document correctly references parent ADRs or related TDDs.
  • Drift: Identify if the proposed design contradicts existing mandates in GEMINI.md.

Final Output Format

Deliver your review document-by-document. For each document, provide:

  1. A [Pass/Fail] grade for Structure and Logic.
  2. Detailed feedback and actionable fixes.
  3. The Phase 3 Consistency Report.

Verification

Verify this skill produces correct output:

  1. Create a fixture ADR document with a missing "Alternatives Considered" section.
  2. Run the 3-Phase Audit against it.
  3. Confirm the Structural Audit returns [Fail] and correctly identifies the missing section.
  4. Create a fixture TDD with all required sections present. Confirm it passes Phase 2 logic audit.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.