← Back to Skills Marketplace
athola

Nm Pensive Architecture Review

by athola · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
71
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install nm-pensive-architecture-review
Description
Assess architecture decisions, ADR compliance, coupling analysis, and design principles
README (SKILL.md)

Night Market Skill — ported from claude-night-market/pensive. For the full experience with agents, hooks, and commands, install the Claude Code plugin.

Table of Contents

Testing

Run pytest plugins/pensive/tests/skills/test_architecture_review.py to verify review logic.

Architecture Review Workflow

Architecture assessment against ADRs and design principles.

Quick Start

/architecture-review

When To Use

  • Approving reimplementations.
  • Large-scale refactoring reviews.
  • System design changes.
  • New module/service introduction.
  • Dependency restructuring.

When NOT To Use

  • Selecting architecture paradigms - use archetypes skills
  • API surface review - use api-review
  • Selecting architecture paradigms - use archetypes skills
  • API surface review - use api-review

Progressive Loading

Load modules based on review scope:

  • modules/adr-audit.md (~400 tokens): ADR verification and documentation.
  • modules/coupling-analysis.md (~450 tokens): Dependency analysis and boundary violations.
  • modules/principle-checks.md (~500 tokens): Code quality, security, and performance.
  • modules/fpf-methodology.md (~800 tokens): FPF (Functional, Practical, Foundation) multi-perspective review methodology.

Load all modules for full reviews. For focused reviews, load only relevant modules.

Required TodoWrite Items

  1. arch-review:context-established: Repository, branch, motivation.
  2. arch-review:adr-audit: ADR verification and new ADR needs.
  3. arch-review:interaction-mapping: Module coupling analysis.
  4. arch-review:principle-checks: LoD, security, performance.
  5. arch-review:risks-actions: Recommendation and follow-ups.

Workflow

Step 1: Establish Context (arch-review:context-established)

Confirm repository and branch:

pwd
git status -sb

Document:

  • Feature/bug/epic motivating review.
  • Affected subsystems.
  • Architectural intent from README/docs.
  • Design trade-off assumptions.

Step 2: ADR Audit (arch-review:adr-audit)

Load: modules/adr-audit.md

  • Locate ADRs in project.
  • Verify required sections.
  • Check status flow.
  • Confirm immutability compliance.
  • Flag need for new ADRs.

Step 3: Interaction Mapping (arch-review:interaction-mapping)

Load: modules/coupling-analysis.md

  • Diagram before/after module interactions.
  • Verify composition boundaries.
  • Check data ownership clarity.
  • Validate dependency flow direction.
  • Identify coupling violations.

Step 4: Principle Checks (arch-review:principle-checks)

Load: modules/principle-checks.md

  • Law of Demeter.
  • Anti-slop patterns.
  • Security (input validation, least privilege).
  • Performance (N+1 queries, caching).

Step 5: Risks and Actions (arch-review:risks-actions)

Summarize using imbue:diff-analysis/modules/risk-assessment-framework:

  • Current vs proposed architecture.
  • Business impact.
  • Technical debt implications.

List follow-ups with owners and dates.

Provide recommendation:

  • Approve: Architecture sound.
  • Approve with actions: Minor issues to address.
  • Block: Fundamental problems requiring redesign.

Architecture Principles Checklist

Coupling

  • Dependencies follow defined boundaries.
  • No circular dependencies.
  • Extension points used properly.
  • Abstractions don't leak.

Cohesion

  • Related functionality grouped.
  • Single responsibility per module.
  • Clear module purposes.

Layering

  • Layers have clear responsibilities.
  • Dependencies flow downward.
  • No layer bypassing.

Evolution

  • Changes are reversible.
  • Migration paths are clear.
  • ADRs document decisions.

Troubleshooting

Common Issues

Command not found Ensure all dependencies are installed and in PATH

Permission errors Check file permissions and run with appropriate privileges

Unexpected behavior Enable verbose logging with --verbose flag

Usage Guidance
This skill is coherent with its stated purpose: it reads and analyzes the codebase (find/grep, dependency graph tools, test invocation) and does not request secrets. Before installing or invoking: 1) only run it on repositories you trust, since it will scan files and run test/analysis commands; 2) ensure required analysis tools (pydeps, madge, pytest) are present if you need full functionality; 3) review any Night Market config entries it requests if you use that platform (they are internal config references, not API keys); 4) if you want to restrict autonomous runs, keep it user-invocable only and monitor what reviews are performed.
Capability Analysis
Type: OpenClaw Skill Name: nm-pensive-architecture-review Version: 1.0.0 The skill bundle is a comprehensive architecture and security review tool designed to analyze local codebases for ADR compliance, coupling violations, and design anti-patterns. It utilizes standard system commands (grep, find, git) and common development utilities (pytest, pydeps, madge) to perform static analysis. No evidence of malicious intent, data exfiltration, or unauthorized remote execution was found; the instructions are strictly aligned with the stated purpose of architectural auditing.
Capability Tags
requires-oauth-tokenrequires-sensitive-credentials
Capability Assessment
✓ Purpose & Capability
The name/description match the SKILL.md and included modules (ADR audit, coupling analysis, principle checks, FPF methodology). The declared required config paths (night-market.pensive:shared, night-market.imbue:proof-of-work, night-market.imbue:diff-analysis/modules/risk-assessment-framework) are internal configuration references consistent with producing structured reviews and risk assessments. No unrelated credentials, binaries, or system-wide privileges are requested.
ℹ Instruction Scope
The instructions expect the agent to inspect repository files and run file-search commands (find, grep), static-analysis helpers (pydeps, madge), and tests (pytest plugin). That's normal for an architecture review, but it does mean the skill will read and analyze local code and docs. The SKILL.md does not instruct reading unrelated system paths or exfiltrating data to external endpoints.
✓ Install Mechanism
No install spec or bundled code is present (instruction-only). That minimizes risk because nothing is downloaded or written to disk by the skill itself. The skill does reference external tools (pydeps, madge, pytest) but does not attempt to install them.
ℹ Credentials
The skill requests no environment variables or credentials. It does declare three required config paths in the Night Market config namespace; these appear to be internal configuration hooks for the review workflow and are proportionate to a review/reporting skill. If you do not use Night Market config namespaces, these config requirements are inert.
✓ Persistence & Privilege
always is false and the skill is user-invocable; autonomous invocation is allowed by platform defaults but this skill does not request persistent privileges, nor does it attempt to modify other skills or system-wide settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install nm-pensive-architecture-review
  3. After installation, invoke the skill by name or use /nm-pensive-architecture-review
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the Architecture Review skill. - Provides a structured workflow for reviewing architecture decisions, ADR compliance, coupling, and design principles. - Includes progressive module loading for ADR audits, coupling analysis, principle checks, and methodology review. - Offers a checklist covering coupling, cohesion, layering, and evolution principles. - Specifies required TodoWrite items and step-by-step workflow for running reviews. - Contains troubleshooting guidance and quick start instructions.
Metadata
Slug nm-pensive-architecture-review
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Nm Pensive Architecture Review?

Assess architecture decisions, ADR compliance, coupling analysis, and design principles. It is an AI Agent Skill for Claude Code / OpenClaw, with 71 downloads so far.

How do I install Nm Pensive Architecture Review?

Run "/install nm-pensive-architecture-review" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Nm Pensive Architecture Review free?

Yes, Nm Pensive Architecture Review is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Nm Pensive Architecture Review support?

Nm Pensive Architecture Review is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Nm Pensive Architecture Review?

It is built and maintained by athola (@athola); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463815 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259802 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200680 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191345 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190333 · by oswalpalash

💬 Comments