codebase-design
Design Deeper, More Testable Modules
Shallow modules spread complexity across callers and make tests depend on implementation details. This skill evaluates interfaces, seams, dependencies, and alternatives to improve module depth.
Install with my Agent
Copy this request to your Agent. It includes the canonical Skill page and manifest.
Review the Skillstore skill "codebase-design" from https://skillstore.io/skills/mattpocock-codebase-design.md and its manifest at https://skillstore.io/api/skills/mattpocock-codebase-design/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.Your Agent should still show its plan and request any confirmation required by the security policy.
Agent-readable resources
Use these links when an AI agent, crawler, or script needs clean context instead of reading the full page.
Test it
Using "codebase-design". Review an order workflow with separate validation, pricing, payment, and persistence wrappers.
Expected outcome:
- The wrappers are shallow because callers still coordinate ordering, errors, and shared state.
- A deeper order-processing module can own the workflow behind one operation.
- Inject payment and persistence adapters, then test observable outcomes through the new interface.
Using "codebase-design". Compare two interfaces for sending customer notifications.
Expected outcome:
- The command-oriented interface offers higher leverage for common notification workflows.
- The transport-oriented interface exposes retry, routing, and formatting decisions to every caller.
- Prefer the command-oriented design unless callers genuinely require transport control.
Using "codebase-design". Decide how to test a module that calls an owned internal service.
Expected outcome:
Define a port at the internal service seam, use a production transport adapter, and provide an in-memory adapter for module tests.
Security Audit
SafeAll nine static findings are false positives. Eight findings identify Markdown code fences as shell execution, while the remaining finding identifies an illustrative TypeScript function as reconnaissance. No malicious intent, prompt injection, or executable command behavior was found.
Risk Factors
⚙️ External commands (8)
Share & cite this report
Share the versioned assessment report, neutral badge, embed card, and citations. Skillstore reports evidence without deciding whether this Skill is safe.
Copy report link
https://skillstore.io/skills/mattpocock-codebase-design/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportMarkdown badge
[](https://skillstore.io/skills/mattpocock-codebase-design?utm_source=security_passport_badge)HTML badge
<a href="https://skillstore.io/skills/mattpocock-codebase-design?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/mattpocock-codebase-design/security.svg" alt="Skillstore security assessment" loading="lazy"></a>Embed card
<iframe src="https://skillstore.io/embed/skills/mattpocock-codebase-design.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>Academic citations (APA · BibTeX · CFF)
APA citation
mattpocock. (2026). codebase-design security audit report (audit version 5) [Author version unspecified]. Skillstore. https://skillstore.io/skills/mattpocock-codebase-design/audits/5BibTeX citation
@techreport{mattpocock-mattpocock-codebase-design-2026,
author = {mattpocock},
title = {codebase-design security audit report (audit version 5)},
institution = {Skillstore},
year = {2026},
number = {5},
url = {https://skillstore.io/skills/mattpocock-codebase-design/audits/5},
note = {Author version unspecified}
}CITATION.cff
cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "codebase-design security audit report (audit version 5)"
version: "unspecified"
type: report
authors:
- name: "mattpocock"
date-released: "2026-07-23"
url: "https://skillstore.io/skills/mattpocock-codebase-design/audits/5"
identifiers:
- type: other
value: "skillstore:mattpocock-codebase-design:audit:5"
description: "Skillstore immutable audit report identifier"
Skillstore Score
Why this score Evidence Confidence: MediumWhat You Can Build
Refactor Shallow Modules
Identify pass-through abstractions and consolidate behavior behind a smaller interface.
Review Architecture Changes
Assess seam placement, dependency categories, and interface complexity before approving a redesign.
Improve Test Boundaries
Design interfaces that support observable tests without exposing internal implementation details.
Try These Prompts
Explain whether this module is deep or shallow, using its interface and hidden behavior as evidence.
Review this interface for unnecessary methods, complex parameters, hidden invariants, error modes, and opportunities to increase caller leverage.
Analyze these related modules, classify their dependencies, propose a deeper replacement, and define tests through its external interface.
Create four radically different interfaces, then compare depth, locality, seam placement, dependency strategy, and trade-offs before recommending one design.
Best Practices
- Provide representative callers, current interfaces, and dependency details before requesting a design review.
- Compare alternatives using depth, locality, seam placement, and observable test behavior.
- Validate the recommended interface against real error modes, invariants, performance needs, and migration constraints.
Avoid
- Do not add an interface when only one implementation exists and no variation is required.
- Do not expose internal seams solely to make implementation-level tests easier.
- Do not measure module depth by implementation size or line counts.
Frequently Asked Questions
What is a deep module?
What does interface mean here?
When should I introduce a seam?
How does this skill improve testing?
Can it redesign an entire codebase?
Does it modify source code automatically?
Developer Details
Author
mattpocockLicense
MIT
Skillstore revision
r2
Version notice
The author did not declare a version.
Ref
ebdfe608f5de2b66ff37ab4af12af8ac4f5e8006
Maintenance freshness
7/25/2026
Usage
6 downloads · 0 views
File structure