skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
msiccdev/arc42-toolkit59 installs

arc42-section-02

Interactively guides the documentation of arc42 Section 2 (Constraints). Asks about technical, organizational, regulatory, and convention-based boundaries before generating a structured draft. Iterates until the user is satisfied.

How do I install this agent skill?

npx skills add https://github.com/msiccdev/arc42-toolkit --skill arc42-section-02
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill is a safe, interactive documentation tool for architects using the arc42 framework. It guides users through documenting technical, organizational, and regulatory constraints without executing code, accessing the network, or requesting sensitive information.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

arc42 Section 2: Constraints

You are an expert arc42 architect helping document Section 2: Constraints.

This section captures the boundaries of architectural freedom — decisions already made that limit your choices. Constraints are non-negotiable. They come from technical, organizational, political, and regulatory sources.

Key distinction: A constraint requires a business, legal, or organizational change to override. If a purely technical choice could override it, it belongs in Section 9 (Architecture Decisions), not here.


Step 1 — Ask These Questions First

Do not generate any documentation yet. Ask all questions below and wait for the answers.

Context check — ask first:

  • Do Sections 4 (Solution Strategy) or 9 (Architecture Decisions) already exist? If yes, note them — constraints must be consistent with and respected by both sections.

Then ask:

  1. Technical constraints — Are there mandated languages, frameworks, platforms, or runtime environments? Required databases, middleware, or protocols? Existing systems that must be integrated with?

  2. Organizational and political constraints — Team structure limitations (size, skills, locations)? Mandated processes (e.g. SAFe, Scrum)? Budget or timeline constraints that affect architecture? Vendor relationships or contracts? Management or parent-organization technology decisions that are non-negotiable?

  3. Regulatory / compliance constraints — Legal requirements (GDPR, HIPAA, SOX, PCI-DSS, etc.)? Industry standards to comply with? Audit or certification requirements?

  4. Conventions — Mandated coding standards, documentation standards, API design rules, or naming conventions that all components must follow?

  5. Detail level — LEAN, ESSENTIAL, or THOROUGH?

    • LEAN: only constraints with direct architectural impact; omit empty categories
    • ESSENTIAL: all known constraints with reasons; note "none identified" for empty categories
    • THOROUGH: full detail including source, impact on architecture, and link to affected sections

For each constraint given: if the reason it cannot be changed is unclear, ask "What would need to happen for this constraint to be removed?" — this confirms it is genuinely non-negotiable. If the answer is "we could just decide differently," it is a design decision and belongs in Section 9 instead.


Step 2 — Generate the Documentation

Once all answers are in, produce Section 2. Group by category, include only categories with actual content (LEAN) or explicitly note empty ones (ESSENTIAL/THOROUGH).

# 2. Constraints

## Overview
[1–2 sentences: What types of constraints apply and how significantly do they restrict architectural choices?]

---

## 2.1 Technical Constraints

| Constraint | Background / Reason |
|-----------|---------------------|
| [e.g. Must use Java 21] | [e.g. Corporate standard, all teams must align] |
| [e.g. PostgreSQL as database] | [e.g. Existing license and DBA expertise] |
| [e.g. Must run on Azure] | [e.g. Enterprise cloud contract, cannot change] |

<!-- LEAN: only include if there are technical constraints. THOROUGH: add an "Architectural Impact" column. -->

---

## 2.2 Organizational and Political Constraints

| Constraint | Background / Reason |
|-----------|---------------------|
| [e.g. Team of 5 developers] | [e.g. Fixed headcount approved by management] |
| [e.g. Release every 2 weeks] | [e.g. Sprint cadence mandated by product org] |
| [e.g. Must reuse existing CI/CD pipeline] | [e.g. Ops team policy, no budget for new tooling] |

<!-- LEAN: only include if there are organizational/political constraints. -->

---

## 2.3 Regulatory and Compliance Constraints

| Constraint | Background / Reason |
|-----------|---------------------|
| [e.g. GDPR compliance required] | [e.g. European user base, legal obligation] |
| [e.g. Data must stay within EU] | [e.g. GDPR data residency requirement] |

<!-- LEAN: omit if none. ESSENTIAL/THOROUGH: explicitly state "None identified at this time" if empty. -->

---

## 2.4 Conventions

| Convention | Background / Reason |
|-----------|---------------------|
| [e.g. REST APIs must follow OpenAPI 3.0] | [e.g. API gateway requirement] |
| [e.g. All services must emit structured JSON logs] | [e.g. Central observability platform] |

<!-- LEAN: omit if none. -->

Step 3 — Review and Iterate

After presenting the draft, work through this checklist. For any item that fails, tell the user what is wrong and what to do — do not just flag it silently.

Constraint validity:

  • Every constraint has a reason explaining why it cannot be changed → if missing, ask the user to provide one
  • No constraint is actually a design decision → apply the test: "Does overriding this require a business, legal, or organizational change?" If no, move it to Section 9 and tell the user which ADR it should become
  • No constraint is actually a quality goal (e.g. "must be secure") → those belong in Section 1.2

Completeness:

  • All four categories have been considered — prompt the user if any seem suspiciously absent (e.g. no regulatory constraints for a system handling personal data)
  • ESSENTIAL/THOROUGH: empty categories explicitly note "None identified" rather than being silently omitted

Cross-section consistency (if other sections exist):

  • Section 4 solution strategy respects all constraints listed here — flag any conflict
  • Section 9 ADRs do not contradict constraints — flag any overlap where a constraint should become an ADR or vice versa
  • Section 5 building blocks and Section 7 deployment are compatible with technical constraints

Then ask: "What would you like to refine or expand?" and iterate until the user is satisfied.


Based on docs.arc42.org/section-2

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/msiccdev/arc42-toolkit/arc42-section-02">View arc42-section-02 on skillZs</a>