https://markus.wondrax.cloud/ Writing on agentic coding, software architecture, and building meaningful tools. en https://markus.wondrax.cloud/articles/spec-kit-organization.html https://markus.wondrax.cloud/articles/spec-kit-organization.html Mon, 21 Sep 2026 00:00:00 +0000 Spec-Kit artifacts are packages and dependencies: catalogs publish what is available, bundles pin what a project installs, and the repository keeps only project intent and project-owned customization. Markus Wondrak Spec Kit Agentic Coding Workflow Best Practices https://markus.wondrax.cloud/articles/agent-skills-gaps.html https://markus.wondrax.cloud/articles/agent-skills-gaps.html Mon, 25 May 2026 00:00:00 +0000 The Agent Skills specification defines a context layer for AI agents: instructions, domain rules, and supporting files that travel with the codebase and shape agent behaviour. The format succeeded by staying minimal. Five gaps around variables, triggers, scoping, composition, and workflow execution are now generating proposals that would close them by adding execution logic to the format. Each gap has a cleaner answer — one that keeps the context layer honest and the orchestrator responsible. Markus Wondrak Agentic Coding Skills Developer Experience Architecture https://markus.wondrax.cloud/articles/deterministic-pipelines.html https://markus.wondrax.cloud/articles/deterministic-pipelines.html Thu, 14 May 2026 00:00:00 +0000 Agents are probabilistic by design. Hard workflow guarantees — phase gates, enforced sequencing, human checkpoints — cannot be achieved by giving an agent better instructions. They require a runtime the agent cannot override. Spec-Kit's workflow engine provides one. Markus Wondrak Agentic Coding Spec Kit Architecture Workflows https://markus.wondrax.cloud/articles/documentation-agentic-coding.html https://markus.wondrax.cloud/articles/documentation-agentic-coding.html Thu, 30 Apr 2026 00:00:00 +0000 Agentic coding scales output — and, without the right context layer, scales misalignment at the same rate. arc42's twelve structured sections already satisfy most of what agents need from documentation. The missing piece is not a new framework: it's putting the documentation in the repository, as Markdown files, where agents can actually find it. Markus Wondrak Agentic Coding arc42 Architecture Documentation https://markus.wondrax.cloud/articles/spec-kit-reevaluation.html https://markus.wondrax.cloud/articles/spec-kit-reevaluation.html Sun, 26 Apr 2026 00:00:00 +0000 GitHub's Spec Kit promises structured SDLC automation for agentic coding. After a second evaluation, here's what improved — and three enterprise gaps that still remain. Markus Wondrak Agentic Coding Spec Kit Architecture Enterprise