CtrlK
BlogDocsLog inGet started
Tessl Logo

034-architecture-design-exploration

Use when a sanitized issue summary, requirement summary, or design brief needs technical design exploration before creating ADRs, specifications, or implementation plans. This skill inspects repository context, clarifies material ambiguity, compares feasible approaches and trade-offs, recommends a direction, obtains approval, and identifies ADR candidates. This should trigger for requests such as Explore a design; Compare implementation approaches; Recommend an architecture direction; Clarify technical options before planning. Part of cursor-rules-java project

80

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, concise process skill with a clearly sequenced 5-step workflow, explicit gates (trust gate, approval), and a single verified one-level-deep reference. The only tightening opportunity is the "When to use" list echoing the description's triggers.

DimensionReasoningScore

Conciseness

The body is lean with no concept-explanation padding and assumes Claude's competence; each section (scope, constraints, triggers, workflow, reference) serves a distinct purpose. It avoids a 2 only because the mild "When to use" duplication of the description's triggers does not rise to the verbosity/padding the 2 anchor describes.

3 / 3

Actionability

"Read references/034-architecture-design-exploration.md, the sanitized issue or requirement summary, relevant code, existing ADRs, diagrams, and constraints" and "compare complexity, maintainability, performance, security, testability, migration impact, operational cost" name exact artifacts and dimensions. As an instruction-only skill the absence of code is not penalized; it is not a 2 because the guidance is complete and concrete rather than vague or pseudocode-like.

3 / 3

Workflow Clarity

Five numbered steps carry explicit checkpoints — "Resolve blocking ambiguity with focused questions before comparing solutions," the TRUST GATE, and "Obtain user approval before treating a direction as selected" — with the Constraints block acting as a MUST/MUST NOT checklist. It is not a 2 because checkpoints are explicit rather than implicit, and the operations are not destructive/batch so the workflow_clarity cap does not apply.

3 / 3

Progressive Disclosure

The body is an overview pointing to a single, clearly signaled one-level-deep reference — "[references/034-architecture-design-exploration.md](references/034-architecture-design-exploration.md)" — and that file exists on disk. It is not a 2 because the reference is well-signaled and shallow rather than inline or nested.

3 / 3

Total

12

/

12

Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, specific description with explicit "Use when" triggers, a comprehensive concrete action list, and a distinct architecture-design niche. The trailing "Part of cursor-rules-java project" provenance tag adds slight noise but creates no conflict risk.

DimensionReasoningScore

Specificity

"inspects repository context, clarifies material ambiguity, compares feasible approaches and trade-offs, recommends a direction, obtains approval, and identifies ADR candidates" lists multiple specific concrete actions. It is not a 2 because the action list is comprehensive rather than naming only a domain and partial actions.

3 / 3

Completeness

It answers "what" with an explicit action list and "when" with both a "Use when a sanitized issue summary... needs technical design exploration" clause and a "This should trigger for requests such as..." clause. It is not a 2 because the trigger guidance is explicit rather than implied.

3 / 3

Trigger Term Quality

"Explore a design; Compare implementation approaches; Recommend an architecture direction; Clarify technical options before planning" are natural phrases a user would actually say. It is not a 2 because several common variations are covered rather than a single keyword.

3 / 3

Distinctiveness Conflict Risk

The niche — sanitized-summary-driven architecture/ADR design exploration — is specific with distinct triggers unlikely to overlap other skills. It is not a 2 because the triggers point to a clear, narrow domain rather than a broad "works with documents" scope.

3 / 3

Total

12

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
jabrena/cursor-rules-java
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.