architecture design

Design Community

Skill notes

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

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;

Workflow

Read architecture and workflow. Run self-check before runtime claims; it uses dediren-release.sh to resolve the pinned GitHub™ release bundle.

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
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.

Author source file SKILL.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
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` |

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.