architecture design
- Repo stars 0
- Author repo skills
- Domain
- Design
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @tommimarkus · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Write / modify
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# Architecture Design
Build, Extract, Review, and Lookup ArchiMate® and UML® dediren packages. This is
the router; load references only when their conditions apply.
## Package
Canonical source is `docs/architecture/<feature>.dediren/`: edit source and
policies, recreate generated output, use SVG as proof, treat OEF/XMI as optional
compatibility export, and list only actual views in `project.json`.
## Boundary
Owns ArchiMate® and UML® notation when the artifact is a dediren
architecture/design package, package source/policies, SVG/OEF/XMI evidence,
drift, cross-notation `properties.uml.architecture_context` handoff links, and
`ARCH-*` findings. Delegate UI, API, infra, security, test-quality, live cloud
observation, and implementation details that are not being modeled as package
handoff facts.
## Inputs
Pre-flight: inspect prompt, target package/source paths, existing dediren source,
selected notation/profile, rendered SVG/OEF/XMI evidence, validation logs,
requested mode, quality target, and export need. Infer only the default mode. If
target/evidence/scope is missing or ambiguous, ask the user before
edits/findings.
## Modes
- **Build**: create/edit package source from architect intent.
- **Extract**: lift evidenced code/IaC/API/UI/workflow facts; mark
architect-owned content. Put source-backed groups in `model.json` under
`plugins.generic-graph.views[].groups`, not `project.json`.
- **Review**: assess validity, readability, SVG, optional export, and drift;
lead with findings.
- **Lookup**: answer bounded notation/package/reverse-lookup questions only.
Default: architect intent -> Build; source without package -> Extract; supplied
package/readiness/drift -> Review; narrow fact -> Lookup. Refuse forward-only
Business, Motivation, Strategy, or Physical extraction from source; suggest
Build.
## Workflow
1. Read [architecture](../../docs/architecture-reference/architecture.md) and
[workflow](references/procedures/architecture-operational-workflow.md).
2. Run [self-check](references/procedures/self-check.md) before runtime claims;
it uses [dediren-release.sh](references/scripts/dediren-release.sh) to
resolve the pinned GitHub™ release bundle.
3. Select notation from `plugins.generic-graph.semantic_profile`, view kinds,
export request, or prompt. Load `references/notations/archimate.md` for
ArchiMate, `references/notations/uml.md` for UML®, and both for mixed
packages.
4. Preserve ids, labels, source evidence, policies, architect-owned intent, and
explicit cross-notation links.
5. Load task references below. In Extract mode, load
`references/source-weighting.md` before selecting ArchiMate element,
relationship, or view types unless the task is a purely mechanical update to
an existing package. Keep a compact rationale for every non-obvious
source-to-ArchiMate choice. Build/Extract may mutate source; Review/Lookup
do not mutate by default.
6. Validate before quality claims; return [output](references/output-format.md).
7. Stop when required evidence is missing, dediren returns an error envelope,
the notation is unsupported, or a blocking finding prevents requested
readiness.
## References
| Need | Use |
|---|---|
| ArchiMate notation/profile | `references/notations/archimate.md` |
| UML® notation/profile and ArchiMate handoff links | `references/notations/uml.md` |
| Review/readiness | `references/smell-catalog.md`, `references/red-flags.md`, `references/procedures/professional-readiness.md` |
| implementation-readiness review | `references/procedures/implementation-readiness-review.md` |
| Source-weighted ArchiMate element/relation selection | `references/source-weighting.md`; details in `../../docs/architecture-reference/source-weighting.md` |
| Drift | `references/procedures/drift-detection.md` |
| OEF/downstream validation | `references/procedures/external-validation-handoff.md` |
| Dediren release resolver | `references/scripts/dediren-release.sh`; use through self-check before runtime claims, and run `bash -n references/scripts/dediren-release.sh` when editing the resolver |
| .NET extraction | `references/procedures/lifting-rules-dotnet.md` |
| Java extraction | `references/procedures/lifting-rules-java.md` |
| Bicep extraction | `references/procedures/lifting-rules-bicep.md` |
| GitHub Actions extraction | `references/procedures/lifting-rules-gha.md` |
| Process extraction | `references/procedures/lifting-rules-process.md`, `references/procedures/process-view-emission.md`, `references/procedures/seed-views.md` |
| Examples/smoke tests | `references/fixtures/dediren/basic/` |
| Skill maintenance | `references/evals`, `references/source-grounding.md` |
Sections and files
Listed in source order.
sections -> Package → Boundary → Inputs → Modes → Workflow → References
terms -> Build · Extract · Review · Lookup
files/cmd -> docs/architecture/<feature>.dediren/ · project.json · properties.uml.architecture_context · ARCH-* · model.json · plugins.generic-graph.views[].groups · plugins.generic-graph.semantic_profile · references/notations/archimate.md
body sha256 -> f4563f71832d
Package
Canonical source is
docs/architecture/<feature>.dediren/: edit source and policies, recreate generated output, use SVG as proof, treat OEF/XMI as optional compatibility export, and list only actual views inproject.json.Boundary
Owns ArchiMate® and UML® notation when the artifact is a dediren architecture/design package, package source/policies, SVG/OEF/XMI evidence, drift, cross-notation
properties.uml.architecture_contexthandoff links, andARCH-*findings. Delegate UI, API, infra, security, test-quality, live cloud observation, and implementation details that are not being modeled as packageInputs
Pre-flight: inspect prompt, target package/source paths, existing dediren source, selected notation/profile, rendered SVG/OEF/XMI evidence, validation logs, requested mode, quality target, and export need. Infer only the default mode. If target/evidence/scope is missing or ambiguous, ask the user before edits/findings.
Modes
Build: create/edit package source from architect intent. Extract: lift evidenced code/IaC/API/UI/workflow facts; mark architect-owned content. Put source-backed groups in
model.jsonunderplugins.generic-graph.views[].groups, notproject.json. Review: assess validity, readability, SVG, optional export, and drift;Workflow
Read architecture and workflow. Run self-check before runtime claims; it uses dediren-release.sh to resolve the pinned GitHub™ release bundle.