[Extension]: Add intent

[SuhaibAslam]

Extension ID

intent

Extension Name

Intent Reconciliation

Version

1.0.2

Description

Reconcile implementation-discovered decisions against approved feature intent.

Author

SuhaibAslam

Repository URL

https://github.com/SuhaibAslam/spec-kit-reconcile

Download URL

https://github.com/SuhaibAslam/spec-kit-reconcile/archive/refs/tags/v1.0.2.zip

License

MIT

Homepage

https://github.com/SuhaibAslam/spec-kit-reconcile

Documentation URL

https://github.com/SuhaibAslam/spec-kit-reconcile/blob/main/README.md

Changelog URL

https://github.com/SuhaibAslam/spec-kit-reconcile/blob/main/CHANGELOG.md

Required Spec Kit Version

=0.12.0

Required Tools

None. The extension has no runtime dependencies.

Number of Commands

3

Number of Hooks

0

Tags

intent, decisions, reconciliation, drift, workflow

Key Features

• Establishes a compact, explicitly approved intent.md artifact.
• Records implementation discoveries in an append-only decision ledger.
• Classifies discoveries as implementation defects, contract discoveries, design decisions, intent changes, or accidental divergence.
• Provides a fail-closed speckit.intent.implement wrapper that stops before implementation unless intent reports READY.
• Requires explicit human resolution before propagating decisions into intent, specs, plans, tests, tasks, or code.
• Clearly documents that calling core speckit.implement directly bypasses reconciliation.

Testing Checklist

• Extension installs successfully via download URL
• All commands execute without errors
• Documentation is complete and accurate
• No security vulnerabilities identified
• Tested on at least one real project

Submission Requirements

• Valid extension.yml manifest included
• README.md with installation and usage instructions
• LICENSE file included
• GitHub release created with version tag
• All command files exist and are properly formatted
• Extension ID follows naming conventions

Testing Details

Environment

• macOS
• Spec Kit 0.14.4.dev0
• Codex CLI 0.146.0-alpha.3.1

Automated validation

• Six focused tests passed locally.
• GitHub Actions passed: https://github.com/SuhaibAslam/spec-kit-reconcile/actions/runs/30455601197
• Manifest command namespaces are asserted to match the intent extension ID.

Release installation

1. Initialized a clean Spec Kit project with the Codex skills integration and Python scripts.
2. Installed from the public v1.0.2 archive URL using the intent ID.
3. Verified all three skills were generated:
   • speckit-intent-confirm
   • speckit-intent-decisions
   • speckit-intent-implement
4. Verified sibling-command tokens rendered to integration-correct invocations without unresolved placeholders.

Behavioral validation

• The fail-closed wrapper was previously executed against a real feature without approved intent and returned RECONCILE_STATUS: BLOCKED_INTENT.
• Core implementation did not run, the requested marker remained absent, and no files changed.
• The decision command returned RECONCILE_STATUS: PENDING without approved intent and made no changes.
• Version 1.0.2 changes only the extension/command namespace and sibling-command references; the gate and decision behavior are unchanged.

Example Usage

specify extension add intent \
  --from https://github.com/SuhaibAslam/spec-kit-reconcile/archive/refs/tags/v1.0.2.zip

Then use the reconciliation entrypoint exposed by the active integration, for example:

$speckit-intent-implement Implement the next incomplete user-story phase.

Proposed Catalog Entry

{
  "intent": {
    "name": "Intent Reconciliation",
    "id": "intent",
    "description": "Reconcile implementation-discovered decisions against approved feature intent",
    "author": "SuhaibAslam",
    "version": "1.0.2",
    "download_url": "https://github.com/SuhaibAslam/spec-kit-reconcile/archive/refs/tags/v1.0.2.zip",
    "repository": "https://github.com/SuhaibAslam/spec-kit-reconcile",
    "homepage": "https://github.com/SuhaibAslam/spec-kit-reconcile",
    "documentation": "https://github.com/SuhaibAslam/spec-kit-reconcile/blob/main/README.md",
    "changelog": "https://github.com/SuhaibAslam/spec-kit-reconcile/blob/main/CHANGELOG.md",
    "license": "MIT",
    "category": "process",
    "effect": "read-write",
    "requires": {
      "speckit_version": ">=0.12.0"
    },
    "provides": {
      "commands": 3,
      "hooks": 0
    },
    "tags": [
      "intent",
      "decisions",
      "reconciliation",
      "drift",
      "workflow"
    ],
    "verified": false,
    "downloads": 0,
    "stars": 0,
    "created_at": "2026-07-29T00:00:00Z",
    "updated_at": "2026-07-29T00:00:00Z"
  }
}

Additional Context

This replaces #3852 after the catalog workflow identified an ID conflict with the existing reconcile extension. The corrected release uses the unique ID intent, matches all command namespaces to that ID, and has been installed successfully from its public archive.

The standalone design follows maintainer guidance from core PR #3848 and addresses its blocking-semantics review: it registers no lifecycle hooks and uses one wrapper command with an explicit fail-closed status contract.

This submission was prepared autonomously on behalf of @SuhaibAslam by Codex (model: GPT-5).

[github-actions]

cc @github/spec-kit-maintainers — new catalog submission for review.

[github-actions]

Pull request created: #3858

Generated by Add Community Extension from Issue Submission · 231.5 AIC · ⌖ 26.8 AIC · ⊞ 35.3K