0.0.0-alpha.4

Architekton 0.0.0-alpha.4 turns the complete Gateway Server dogfood into a stronger, still-conservative experimental alpha.

Added

• architekton:verify, a read-only, diff-aware and intent-aware checker with explicit independent or degraded assessment provenance.
• Bounded static GitHub Actions analysis for overlapping triggers, notification error masking, conditional or path-filtered required-check risk, notification check noise, docs-only validation gaps, unsafe .gitignore classification, runtime version drift, and Dependabot target-branch conflicts.
• Exact handoffs for hosted GitHub controls, security state, Slack receipt, and other outcomes that local inspection cannot prove.
• Regression coverage derived from sanitized Gateway Server dogfooding scenarios.

Changed

• architekton:inspect now separates effective state, conflicts, verified facts, unknown or unsupported facts, exact next actions, and optional deeper checks.
• architekton:bootstrap now proactively recommends a canonical ENGINEERING.md when practice is fragmented and requires at least one real maintainer-answer round.
• architekton:maintain now treats existing ENGINEERING.md as first-class, shows the exact proposal early, and accepts one approval for an unchanged proposal.
• Engineering contracts are detected structurally. The legacy Architekton marker is optional and non-normative.
• Deterministic findings now disclose scope, evidence type, and limitations; actionable unknowns include bounded handoffs.

Safety and limitations

• Inspection and verification remain read-only.
• Static workflow analysis does not execute GitHub Actions or prove hosted configuration, Slack receipt, deployment, or runtime success.
• Arbitrary code, workflow, configuration, and hosted remediation remains outside architekton:maintain.

0.0.0-alpha.3

Architekton 0.0.0-alpha.3 is a small presentation release for the existing experimental alpha.

Changes:

• adds an Architekton composer icon and light/dark plugin logos based on the project architectural-path mark and Satyam Pariyar website design system
• points the Codex plugin Website field to the canonical technical essay
• keeps architekton:inspect as the headline read-only surface, with architekton:bootstrap and architekton:maintain as guarded previews

The evidence model, deterministic coverage, report schema, compatibility surface, and experimental-alpha limitations remain unchanged.

Technical essay: https://www.satyampariyar.com/blog/engineering-practice-is-distributed-state
Repository: https://github.com/pariyar07/architekton

Architekton 0.0.0-alpha.2 — Experimental Alpha

Architekton makes repository engineering practice explicit, reviewable, and usable by humans and agents.

This experimental alpha is inspect-led:

• architekton:inspect performs safe, read-only discovery and reports evidence as pass, fail, unknown, stale, unsupported, or conflicting.
• architekton:bootstrap is a guarded preview for creating one root ENGINEERING.md after a complete interview and exact path, byte, and SHA-256 approval.
• architekton:maintain is a guarded preview for explicitly approved updates to existing guidance. It never creates AGENTS.md or CLAUDE.md.
• Deterministic structural analyzers cover bounded JavaScript/TypeScript, skills-repository, and engineering-contract evidence; other ecosystems remain guided inspection.

Verified at commit 200be40859f1bb9cd36c2c66a540dbb7ca2108c7:

• 64 tests pass.
• Type-check, build, generated-adapter consistency, and Claude plugin validation pass.
• Hosted GitHub Actions CI passed: https://github.com/pariyar07/architekton/actions/runs/29898055600
• Public marketplace installation, real inspect invocation, and removal passed in isolated Codex and Claude Code smoke tests without changing the inspected repository.

Read the installation, invocation, removal, limitations, support, and security guidance in the repository README before use.

This is an experimental prerelease. Its report schema, adapters, compatibility, and preview workflows are not stable APIs.