architecture-design
- Repo stars 0
- Author repo skills
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.jsonunderplugins.generic-graph.views[].groups, notproject.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
- Read architecture and workflow.
- Run self-check before runtime claims; it uses dediren-release.sh to resolve the pinned GitHub™ release bundle.
- Select notation from
plugins.generic-graph.semantic_profile, view kinds, export request, or prompt. Loadreferences/notations/archimate.mdfor ArchiMate,references/notations/uml.mdfor UML®, and both for mixed packages. - Preserve ids, labels, source evidence, policies, architect-owned intent, and explicit cross-notation links.
- Load task references below. In Extract mode, load
references/source-weighting.mdbefore 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. - Validate before quality claims; return output.
- 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 |
- Fluxly category
- 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
- Author / version / license
- @tommimarkus · no license declared
- Fluxly token estimate
- Lean
- Fluxly setup estimate
- Plug-and-play
- External API key
- No requirement detected
- Detected OS requirements
- Unspecified
- Runtime requirements
- Unspecified
- Detected file/system behavior
-
- Read-only
- Write / modify
- Detected network behavior
- Local-only
- Install commands
- None (reference only)
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
The current SKILL.md does not define a fixed output example. 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.
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.architecturecontext handoff links, and
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
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
Read architecture and workflow. Run self-check before runtime claims;
Need · Use ArchiMate notation/profile · references/notations/archimate.md UML® notation/profile and ArchiMate handoff links · references/notations/uml.md
# 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
… Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.
sections -> Package → Boundary → Inputs → Modes → Workflow → References
terms -> Build · Extract · Review · Lookup
files/cmd -> docs/architecture/<feature>.dediren/ · project.json · properties.uml.architecturecontext · ARCH- · model.json · plugins.generic-graph.views[].groups · plugins.generic-graph.semanticprofile · references/notations/archimate.md
body sha256 -> f4563f71832d
Decide Fit First
Design Intent
How To Use It
Boundaries And Review