Offline-first: no network, no telemetry, no LLM/API dependency.
Trust flow
A verdict binds subjectDigest + evidenceDigest + profile + result. Editing any verified state flips the verdict to STALE and fails the gate until you re-verify. See Verification and Trust Flow.
ackit-speckit verify --profile standard # PASS (exit 0)
+ackit-speckit gate # PASS (exit 0)
+# ... edit specs/001-*/spec.md ...
+ackit-speckit status # STALE
+ackit-speckit gate # FAIL (exit 1, VERDICT_STALE)
+ackit-speckit verify --profile standard # PASS again
+ackit-speckit checkpoint
+ackit-speckit handoff
+ackit-speckit complete # only after fresh PASS gate
"Verified" means "verified this exact state". Any subject change — spec, plan, tasks, mapped ACKit task, configs, Git diff — stales the verdict by construction.
A verdict binds subjectDigest + evidenceDigest + profile + result. The subject digest covers Spec Kit artifacts, the ACKit task/config/policy snapshot, bridge config/profile/version, tool versions, and Git HEAD/diffs. The evidence digest covers redacted per-check outputs.
ackit-speckit verify --profile standard
+ackit-speckit gate
Freshness
status / gate recompute the subject digest: equal → FRESH, differ → STALE (gate fails, exit 1), missing → NOT_VERIFIED. stalePolicy: fail is the only supported policy.
+
+
+
+
diff --git a/agent-context-kit/llms-full.txt b/agent-context-kit/llms-full.txt
index c43475f..a990004 100644
--- a/agent-context-kit/llms-full.txt
+++ b/agent-context-kit/llms-full.txt
@@ -404,10 +404,20 @@ Guide: [`docs/guides/vscode.md`](docs/guides/vscode.md)
|---|---|
| Architecture | [`docs/architecture/overview.md`](docs/architecture/overview.md) |
| Concepts | `instruction-graph` · `context-budget` · `provider-profiles` · `readiness` · [`workflows`](docs/concepts/workflows.md) · [`intent`](docs/concepts/intent.md) · [`checkpoints`](docs/concepts/checkpoints.md) · [`evidence-verification`](docs/concepts/evidence-verification.md) |
-| Guides | [`getting-started`](docs/guides/getting-started.md) · [`readiness`](docs/guides/readiness.md) · [`optimize`](docs/guides/optimize.md) · [`provider-profiles`](docs/guides/provider-profiles.md) · [`instruction-graph`](docs/guides/instruction-graph.md) · [`rule-packs`](docs/guides/rule-packs.md) · [`ci`](docs/guides/ci.md) · [`watch-dashboard`](docs/guides/watch-dashboard.md) · [`diagnostics`](docs/guides/diagnostics.md) · [`sdk`](docs/guides/sdk.md) · [`vscode`](docs/guides/vscode.md) · [`monorepo`](docs/guides/monorepo.md) · [`workflow-adoption`](docs/guides/workflow-adoption.md) · [`workflow-example`](docs/guides/workflow-example.md) · [`demo-trust-flow`](docs/guides/demo-trust-flow.md) |
+| Guides | [`getting-started`](docs/guides/getting-started.md) · [`readiness`](docs/guides/readiness.md) · [`optimize`](docs/guides/optimize.md) · [`provider-profiles`](docs/guides/provider-profiles.md) · [`instruction-graph`](docs/guides/instruction-graph.md) · [`rule-packs`](docs/guides/rule-packs.md) · [`ci`](docs/guides/ci.md) · [`watch-dashboard`](docs/guides/watch-dashboard.md) · [`diagnostics`](docs/guides/diagnostics.md) · [`sdk`](docs/guides/sdk.md) · [`vscode`](docs/guides/vscode.md) · [`monorepo`](docs/guides/monorepo.md) · [`workflow-adoption`](docs/guides/workflow-adoption.md) · [`workflow-example`](docs/guides/workflow-example.md) · [`demo-trust-flow`](docs/guides/demo-trust-flow.md) · [`spec-kit-bridge`](docs/guides/spec-kit-bridge.md) |
| Reference | `cli` · `config` · `rules` · `readiness` · `profile` · `rule-pack` · `instruction-graph` · `diagnostics` · `sdk` · `exit-codes` · `mcp` · `schemas` · [`drift`](docs/reference/drift.md) · [`policy`](docs/reference/policy.md) · [`status`](docs/reference/cli.md#cli-reference) · [`provider-surfaces`](docs/reference/provider-surfaces.md) |
| Decisions | [`docs/decisions/`](docs/decisions/) · `v0.2.0`: [`docs/v0.2.0/`](docs/v0.2.0/) · `ADR-0025..0028`: workflow/evidence/checkpoint/policy-v2 |
| Tasks | [`docs/tasks/active`](docs/tasks/active) |
+| Ecosystem | [Spec Kit bridge](docs/guides/spec-kit-bridge.md) — community integration ([`@cynrath/ackit-spec-kit-bridge`](https://github.com/Cynrath/ackit-spec-kit-bridge)) connecting Spec Kit intent artifacts to ACKit tasks, evidence, verification gates, and handoffs |
+
+---
+
+### 🔗 Ecosystem
+
+Community integration for ACKit and GitHub Spec Kit: [Spec Kit bridge](docs/guides/spec-kit-bridge.md)
+([`@cynrath/ackit-spec-kit-bridge`](https://github.com/Cynrath/ackit-spec-kit-bridge)) connects
+Spec Kit's intent-driven development artifacts to ACKit's deterministic repository context, task
+lifecycle, evidence, verification, and completion gates. Offline-first, no telemetry.
---
@@ -463,6 +473,21 @@ All notable changes to ACKit (`@cynrath/agent-context-kit`) are documented in th
This project follows Semantic Versioning.
+## [Unreleased]
+
+### Added
+
+- Community integration docs for GitHub Spec Kit: new
+ `docs/guides/spec-kit-bridge.md`, README ecosystem section and docs index
+ link pointing at [`@cynrath/ackit-spec-kit-bridge`](https://github.com/Cynrath/ackit-spec-kit-bridge)
+ (bridge CLI + native Spec Kit extension + `ackit-verified-sdd` workflow).
+ No ACKit core behavior changed.
+- Bridge 0.1.1 cross-links: ownership boundaries (Spec Kit owns intent,
+ ACKit owns trust, bridge coordinates), freshness-model summary, and
+ links to the hosted bridge docs
+ ([cynrath.github.io/ackit-spec-kit-bridge](https://cynrath.github.io/ackit-spec-kit-bridge/)),
+ npm, and the bridge repo with explicit community-integration wording.
+
## [0.5.4] - 2026-09-22
Release-recovery patch (no runtime feature behavior beyond 0.5.3; no new
diff --git a/ai-policy.txt b/ai-policy.txt
index a4ea29f..b17c453 100644
--- a/ai-policy.txt
+++ b/ai-policy.txt
@@ -10,7 +10,7 @@ This is a publisher policy document. robots.txt remains the crawler-access contr
- Crawl and index public pages in accordance with robots.txt.
- Retrieve public content in response to a user request.
- Summarize, quote short excerpts, and cite/link to the original page.
-- Use public technical documentation to answer questions about Cynrath and AgentContextKit.
+- Use public technical documentation to answer questions about Cynrath, AgentContextKit, and the ACKit Spec Kit Bridge.
- Cache public content as reasonably necessary for search, retrieval, safety and citation systems.
- Use public content for model improvement or training where the crawler/operator honors robots.txt and applicable law.
@@ -19,6 +19,7 @@ This is a publisher policy document. robots.txt remains the crawler-access contr
- Preserve source attribution when presenting factual claims derived from this site.
- Prefer canonical URLs under https://cynrath.github.io/ and https://github.com/Cynrath/.
- Treat https://github.com/Cynrath/agent-context-kit as the canonical product source for ACKit code and release state.
+- Treat https://github.com/Cynrath/ackit-spec-kit-bridge as the canonical product source for bridge code and release state.
- Do not represent generated summaries as statements endorsed by Cynrath.
- Do not infer or expose private repositories, credentials, personal secrets, unpublished data or non-public account information.
diff --git a/humans.txt b/humans.txt
index a876dd3..b410cf9 100644
--- a/humans.txt
+++ b/humans.txt
@@ -7,6 +7,9 @@ GitHub: https://github.com/Cynrath
Featured: AgentContextKit / ACKit
Repository: https://github.com/Cynrath/agent-context-kit
Documentation: https://cynrath.github.io/agent-context-kit/
+Integration: ACKit Spec Kit Bridge
+Integration repository: https://github.com/Cynrath/ackit-spec-kit-bridge
+Integration documentation: https://cynrath.github.io/ackit-spec-kit-bridge/
Stack: TypeScript, Node.js, .NET, C#, MSSQL, EF Core, Docker, Linux, Cloudflare
/* SITE */
diff --git a/index.html b/index.html
index 8423c4f..2ce81cd 100644
--- a/index.html
+++ b/index.html
@@ -1 +1 @@
-Cynrath — Developer tooling, web systems & infrastructure
Developer tooling · web systems · infrastructure
Developer tools. Web systems. Infrastructure.
TypeScript and .NET for CLI tooling, admin platforms, databases, automation, CI/CD and infrastructure.
Explainable 0–100 scoring across repository readiness categories with strict, baseline and compare modes.
ackit readiness02
Instruction Graph v2
Resolve Codex, Claude, Gemini, Copilot and shared instructions with scope, precedence, provenance and conflict analysis.
ackit instructions --explain03
Provider Profiles
Deterministic provider-aware behavior for Codex, Claude, Copilot, Gemini or generic workflows; CLI, SDK, MCP, Action and VS Code share one status snapshot.
ackit pack --profile codex04
Context Packs
Build deterministic, token-budgeted repository context with weighted ranking and per-file manifest reasons.
ackit pack --max-tokens 5000005
Skills Interop
Validate, install and export portable skills across supported provider layouts without replacing the repository workflow.
ackit skills export --provider claude06
Managed Asset Sync
Preview, check and reconcile ACKit-owned AGENTS blocks, provider shims and builtin skills without overwriting user-owned content.
ackit sync --dry-run07
Rule + Policy Packs
Apply machine-checkable presence, pattern, config, dependency and instruction rules with composition and scoped overrides.
ackit policy check08
Optimize v2
Detect instruction waste, duplicates and conflicts with evidence, confidence, token estimates and dry-run fixes.
ackit optimize --explain09
Security Scanning
Scan secrets, keys, connection strings, entropy, CI pinning and hygiene findings with redacted evidence and SARIF; link-aware containment hardens outputs.
ackit scan --ci10
Task System
Keep a single active task, explicit task states, artifact references, completion gates and doctor checks.
ackit task11
Workflows + Intent
Run quick, standard or high-risk stage lifecycles backed by committed intent, plans and config-driven completion gates.
ackit workflow show12
Evidence + State-Bound Verification
Link criteria to typed evidence, verify against state-bound bundles and persist independent bound verdicts with replay and staleness refusal.
ackit verification record --bundle13
Portable Handoff + Canonical Status
Resume anywhere with verification-bound handoff packs and the read-only status snapshot: blockers, freshness and next actions.
ackit checkpoint import14
Drift + Policy v2
Detect deterministic workflow drift and enforce risk-tiered autonomy, review policy and declarative lifecycle gates.
ackit drift check --ci15
Roles + Journal
Use portable role contracts and a sanitized append-only local execution journal without capturing hidden reasoning or conversations.
ackit role list16
Watch + Dashboard
Watch repository changes and inspect local readiness, findings and workflow state through a localhost-only dashboard.
ackit dashboard17
Diagnostics + Benchmarks
Produce deterministic diagnostic bundles and measure scan, pack, graph, cache and memory performance against fixtures.
ackit diagnostics bundle18
SDK + MCP
Embed ACKit through its typed SDK or expose the read-only MCP surface for agent integrations.
ackit mcp serve19
VS Code + GitHub Action
Bring ACKit checks into editor Problems, the status-integrated Tasks view and CI with the VS Code extension and GitHub Action.
Cynrath.ackit-vscode20
Trust Flow Demo
Follow the reproducible offline arc from evidence to bound independent verification, status and second-process resume — no API key.
ackit status
03 / ACKit documentation
Everything behind the commands.
Installation, CLI behavior, workflows, evidence, verification, resumability, drift, security guarantees, integrations and migration notes — generated from the ACKit documentation source.
Explainable 0–100 scoring across repository readiness categories with strict, baseline and compare modes.
ackit readiness02
Instruction Graph v2
Resolve Codex, Claude, Gemini, Copilot and shared instructions with scope, precedence, provenance and conflict analysis.
ackit instructions --explain03
Provider Profiles
Deterministic provider-aware behavior for Codex, Claude, Copilot, Gemini or generic workflows; CLI, SDK, MCP, Action and VS Code share one status snapshot.
ackit pack --profile codex04
Context Packs
Build deterministic, token-budgeted repository context with weighted ranking and per-file manifest reasons.
ackit pack --max-tokens 5000005
Skills Interop
Validate, install and export portable skills across supported provider layouts without replacing the repository workflow.
ackit skills export --provider claude06
Managed Asset Sync
Preview, check and reconcile ACKit-owned AGENTS blocks, provider shims and builtin skills without overwriting user-owned content.
ackit sync --dry-run07
Rule + Policy Packs
Apply machine-checkable presence, pattern, config, dependency and instruction rules with composition and scoped overrides.
ackit policy check08
Optimize v2
Detect instruction waste, duplicates and conflicts with evidence, confidence, token estimates and dry-run fixes.
ackit optimize --explain09
Security Scanning
Scan secrets, keys, connection strings, entropy, CI pinning and hygiene findings with redacted evidence and SARIF; link-aware containment hardens outputs.
ackit scan --ci10
Task System
Keep a single active task, explicit task states, artifact references, completion gates and doctor checks.
ackit task11
Workflows + Intent
Run quick, standard or high-risk stage lifecycles backed by committed intent, plans and config-driven completion gates.
ackit workflow show12
Evidence + State-Bound Verification
Link criteria to typed evidence, verify against state-bound bundles and persist independent bound verdicts with replay and staleness refusal.
ackit verification record --bundle13
Portable Handoff + Canonical Status
Resume anywhere with verification-bound handoff packs and the read-only status snapshot: blockers, freshness and next actions.
ackit checkpoint import14
Drift + Policy v2
Detect deterministic workflow drift and enforce risk-tiered autonomy, review policy and declarative lifecycle gates.
ackit drift check --ci15
Roles + Journal
Use portable role contracts and a sanitized append-only local execution journal without capturing hidden reasoning or conversations.
ackit role list16
Watch + Dashboard
Watch repository changes and inspect local readiness, findings and workflow state through a localhost-only dashboard.
ackit dashboard17
Diagnostics + Benchmarks
Produce deterministic diagnostic bundles and measure scan, pack, graph, cache and memory performance against fixtures.
ackit diagnostics bundle18
SDK + MCP
Embed ACKit through its typed SDK or expose the read-only MCP surface for agent integrations.
ackit mcp serve19
VS Code + GitHub Action
Bring ACKit checks into editor Problems, the status-integrated Tasks view and CI with the VS Code extension and GitHub Action.
Cynrath.ackit-vscode20
Trust Flow Demo
Follow the reproducible offline arc from evidence to bound independent verification, status and second-process resume — no API key.
ackit status
Ecosystem
Spec Kit intent, ACKit trust.
AgentContextKit plus GitHub Spec Kit, connected by the ACKit Spec Kit Bridge: spec-driven artifacts mapped into deterministic task state with state-bound verification, completion gates, checkpoints and handoffs. Community integration — not an official GitHub integration.
Offline-first: no network, no telemetry, no LLM/API dependency.
Trust flow
A verdict binds subjectDigest + evidenceDigest + profile + result. Editing any verified state flips the verdict to STALE and fails the gate until you re-verify. See Verification and Trust Flow.
Compatibility
${compatRows}
`},
+ {slug:'getting-started',title:'Getting Started',description:'Install the bridge and run the first sync, verification and gate.',body:`
Getting Started
Requires Node.js 22+, the ACKit CLI, the Spec Kit specify CLI, and Git.
status / gate recompute the subject digest: equal → FRESH, differ → STALE (gate fails, exit 1), missing → NOT_VERIFIED. stalePolicy: fail is the only supported policy.
`},
+ {slug:'profiles',title:'Verification Profiles',description:'quick, standard and high-risk verification profiles.',body:`
Verification Profiles
Ranked quick < standard < high-risk; a higher-rank verdict satisfies a lower-rank gate.
Spec Kit owns intent, specify, plan, tasks, implement, converge. ACKit owns repository context, policy, evidence, verification and completion trust, status, checkpoint, handoff. The bridge coordinates; it replaces neither.
`},
+ {slug:'trust-flow',title:'Trust Flow',description:'Verify, mutate, stale, re-verify: the freshness guarantee.',body:`
Trust Flow
ackit-speckit verify --profile standard # PASS (exit 0)\nackit-speckit gate # PASS (exit 0)\n# ... edit specs/001-*/spec.md ...\nackit-speckit status # STALE\nackit-speckit gate # FAIL (exit 1, VERDICT_STALE)\nackit-speckit verify --profile standard # PASS again\nackit-speckit checkpoint\nackit-speckit handoff\nackit-speckit complete # only after fresh PASS gate
"Verified" means "verified this exact state". Any subject change — spec, plan, tasks, mapped ACKit task, configs, Git diff — stales the verdict by construction.
`},
+ {slug:'troubleshooting',title:'Troubleshooting',description:'Diagnose init, sync, verify and gate failures.',body:`
Troubleshooting
Run ackit-speckit doctor first: stable check IDs pinpoint missing Node/ACKit/Spec Kit/Git prerequisites.
NOT_VERIFIED gate: run verify before gate.
VERDICT_STALE gate: re-run verify; do not bypass — there is no accept-stale flag by design.
exit 2: usage/config error — validate .ackit-spec-kit/config.yml against schemas/config.schema.json.
exit 3: environment/dependency error — check doctor versions against Compatibility.
exit 4: security boundary violation — a path escaped the repository root.
`},
+ {slug:'release',title:'Release Model',description:'Tag-driven OIDC releases with no manual npm approval.',body:`
Release Model
Push vX.Y.Z → GitHub Actions → OIDC Trusted Publishing (npm publish --provenance, no tokens) → registry/shasum/fresh-consumer verification → GitHub Release. Normal releases require no manual npm approval. Bridge ${esc(version)} is the current release.