[Extension]: OKF Knowledge Bundle Generator v0.2.0 #3580

Extension ID

okf

Extension Name

OKF Knowledge Bundle Generator

Version

0.2.0

Description

Generates and maintains an Open Knowledge Format (OKF v0.1) knowledge bundle from a source-code repository

Author

Alex Punnen

Repository URL

https://github.com/alexcpn/speckit_ofk

Download URL

https://github.com/alexcpn/speckit_ofk/archive/refs/tags/v0.2.0.zip

License

MIT

Homepage (optional)

No response

Documentation URL (optional)

No response

Changelog URL (optional)

https://github.com/alexcpn/speckit_ofk/blob/main/CHANGELOG.md

Required Spec Kit Version

=0.12.0

Required Tools (optional)

Number of Commands

3

Number of Hooks (optional)

0

Tags

knowledge, okf, documentation, metadata, catalog

Key Features

• Full bundle generation (/speckit.okf.generate) — scans the repo, plans concepts, writes cross-linked docs, and validates
• Incremental updates (/speckit.okf.update) — diffs git history, updates only stale concepts, preserves human edits
• Conformance validation (/speckit.okf.validate) — checks OKF §9 conformance plus link/secret/quality spot-check

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 (lowercase-with-hyphens)

Testing Details

** Tested on**

OS: Pop!_OS 22.04 LTS (Linux, kernel 6.9.3-76060903-generic, x86_64)
Spec Kit CLI: 0.12.18.dev0 (Python 3.11.15)
LLM / coding agent: Claude Sonnet 5 (via Claude Code CLI)

• Installed the extension via specify extension add okf --from , confirming the dev/URL install path resolves and downloads correctly
• Verified specify extension list shows the extension as enabled with all 3 commands registered (speckit.okf.generate, speckit.okf.update, speckit.okf.validate), 0 hooks
• Validated extension.yml against the manifest schema (caught and fixed an invalid effect value during development)
• Confirmed the release archive URL (https://github.com/alexcpn/speckit_ofk/archive/refs/tags/v0.2.0.zip) is publicly reachable and resolves via GitHub's codeload redirect

Example Usage

#1 Installation
specify extension add okf --from https://github.com/alexcpn/speckit_ofk/archive/refs/tags/v0.2.0.zip

  # 2. Generate the initial knowledge bundle
  # (run from your coding agent, e.g. Claude Code)
  /speckit.okf.generate

  # 3. After making code changes, refresh incrementally
  /speckit.okf.update

  # 4. Validate conformance before committing
  /speckit.okf.validate

Output lands in knowledge/ (configurable) as a set of cross-linked markdown concept files ready to commit alongside your code.

Proposed Catalog Entry

{
    "name": "OKF Knowledge Bundle Generator",
    "id": "okf",
    "description": "Generates and maintains an Open Knowledge Format (OKF v0.1) knowledge bundle from a source-code repository.",
    "author": "Alex Punnen <[email protected]>",
    "version": "0.2.0",
    "download_url": "https://github.com/alexcpn/speckit_ofk/archive/refs/tags/v0.2.0.zip",
    "repository": "https://github.com/alexcpn/speckit_ofk",
    "homepage": "https://github.com/alexcpn/speckit_ofk",
    "license": "MIT",
    "requires": {
      "speckit_version": ">=0.12.0"
    },
    "provides": {
      "commands": 3,
      "hooks": 0
    },
    "tags": ["knowledge", "okf", "documentation", "metadata", "catalog"]
  }

Additional Context

Updated 2026-07-17 to v0.2.0: hardened and updated