PactKit

Format follows Keep a Changelog.

2.1.1 — 2026-03-18

Added

  • Lazy Rule Loading — Rules split into always-load core (01-core-protocol, 02-hierarchy-of-truth, 09-credential-safety) and on-demand @reference layer (6 files loaded by AI via Read tool when needed). Reduces per-turn system prompt overhead by 62% (7,200 → 2,800 tokens).
  • RULES_CORE_FILES, RULES_ONDEMAND_FILES, RULES_INSTRUCTIONS_CORE constants for layered rule management.
  • AGENTS.md contains @rules/xxx.md reference index with lazy-loading instructions.

Changed

  • _update_global_opencode_json() writes individual core rule paths instead of rules/*.md glob.

Fixed

  • _update_global_opencode_json() no longer overwrites user's existing instructions entries (merge instead of replace).

2.1.0 — 2026-03-17

Added

  • FormatProfile Abstraction — Frozen dataclass registry (profiles.py) replaces scattered if-else format branching. Adding a new tool format requires only one registry entry.
  • Prompt Template Variables — 48 hardcoded paths replaced with 11 named placeholders ({SKILLS_ROOT}, {BOARD_CMD}, etc.) resolved at deploy time.
  • Document Schema Registry — New schemas.py centralizes all document structure rules. New CLI command pactkit schema [type].
  • Deploy Chain Parity — OpenCode deployment now matches Classic feature set (selective deploy, config merge, legacy cleanup, project AGENTS.md).
  • Architecture Principles Rule — New 08-architecture-principles.md codifies SOLID, DRY, 12-Factor, and Defense-in-Depth patterns.
  • Daily Retro Skill — Personal growth feedback loop with 6 dimensions.
  • Docker Containers — Isolated deployment verification environments.

Fixed

  • /project-init no longer creates .claude/ in OpenCode environment.
  • Config priority: .opencode/ now takes precedence over .claude/.
  • Scaffold developer prefix auto-injected from pactkit.yaml.

2.0.2 — 2026-03-16

Maintenance release with internal improvements.

1.6.9 — 2026-03-13

Fixed

  • Scaffold template mismatch — create_spec() output now passes spec-lint validation (E001, E004, E008).

1.6.8 — 2026-03-06

Fixed

  • Stale docstring in deployer.py after STORY-064 introduced managed block behavior.
  • Added E2E CLI tests for spec-lint subcommand.

1.6.7 — 2026-03-05

Added

  • Sprint Stage A Model Consistency — Split Stage A into A1-Plan (opus) and A2-Act (sonnet).
  • Persist Venv Config — _upsert_venv_managed_block() writes venv instructions into managed block in CLAUDE.local.md.

Fixed

  • Spec linter path now uses installed CLI entry point (pactkit spec-lint) instead of hardcoded dev path.

1.6.6 — 2026-03-05

Fixed

  • Init hang prevention — Replaced blocking stack detection with config-first resolution and safe fallback.

1.6.5 — 2026-03-04

Fixed

  • Removed unresolvable DEV_REF_FRONTEND/DEV_REF_BACKEND references from Check and Review prompts.

1.6.4 — 2026-03-04

Changed

  • Prompt slimming — Extracted shared protocols to rules.py, eliminating 4-place duplication. Total prompt size: 73K → 57K chars (22.5% reduction).

Added

  • Shared Protocols Rule — New 07-shared-protocols.md with Lazy Visualize, Test Mapping, and Context.md format.

1.6.3 — 2026-03-03

Fixed

  • Sprint Board heading tolerance (### and #### both supported).

1.6.2 — 2026-03-03

Added

  • MCP Recommendations — Post-init display of 6 recommended MCP servers.
  • Subagent Model Selection — Core protocol includes model routing guidance.

1.6.1 — 2026-03-03

Fixed

  • Init hang prevention with Git Guard and enterprise flags.

Changed

  • Removed 10 redundant <thinking> block instructions, saving ~50-100 tokens per invocation.

1.6.0 — 2026-02-28

Added

  • Security Check Scope Filtering — Check phase skips non-applicable SEC-* checks based on Spec scope.

Fixed

  • Routing table accuracy (5 incorrect "Embedded In" claims corrected).
  • Version sync: pactkit.yaml version auto-syncs to __version__.

1.5.0 — 2026-02-27

Added

  • PDCA Quality Gates — Security checklist, lesson scoring, implementation steps in Specs.
  • Deployment Completeness Audit — E2E tests verify exact file counts using VALID_* sets.
  • Impact-Based Regression — visualize impact --entry <func> traces callers for targeted testing.
  • PDCA Streamlining — Split Done into focused Done + Release + PR commands.
  • Community Standards — CODE_OF_CONDUCT.md, SECURITY.md, dependabot.yml.
  • Worktree Isolation — isolation="worktree" for parallel subagent Sprint.

1.4.0 — 2026-02-26

Added

  • Spec Linter — Non-AI structural validation with 8 ERROR + 4 WARN rules.
  • Active Clarify Gate — Auto-detects ambiguous requirements in Plan phase.
  • Pre-Act Consistency Check — Cross-references Spec, Board, and Test Cases.
  • Auto-PR Enhancement — Structured PR body from Spec + Board + test results.
  • Enterprise Flags — --no-git, --no-external, --non-interactive for CI/air-gapped environments.

1.3.1 — 2026-02-25

Fixed

  • Dynamic version in CLAUDE.md (no more hardcoded version strings).
  • /project-init now invokes pactkit init CLI for complete config generation.

1.3.0 — 2026-02-24

Added

  • CI/CD Pipeline Generation — ci.provider config (github/gitlab/none).
  • Issue Tracker Integration — GitHub Issue creation in Plan, closure in Done.
  • Safe Hook Templates — 3 opt-in hooks (pre-commit, post-test, pre-push).
  • Rule Scoping — rule_scopes maps rule IDs to glob patterns.
  • Enhanced Doctor — Stale graph detection, orphaned spec detection, severity levels.
  • Smart Lint — lint_blocking and auto_fix config options.
  • Test Quality Gate — Detects tautological and over-mocked tests.

1.1.4 — 2026-02-24

Added

  • CI lint gate in Done and Act commands.
  • Language matching rule in Core Protocol.
  • Project CLAUDE.md generation via /project-init.
  • Architecture docs staleness prevention in Done command.

1.1.3 — 2026-02-24

Fixed

  • Multi-import graph edges (process all aliases in import a, b, c).
  • Dead code removal in deployer.
  • Archive guard for taskless stories.

1.1.2 — 2026-02-14

Fixed

  • Scripted skill paths (absolute paths in SKILL.md prompts).
  • Plugin mode path rewriting at deploy time.

Added

  • Draw.io MCP integration for instant diagram preview.

1.1.0 — 2026-02-13

Added

  • Config Auto-Merge — pactkit init auto-appends new components to existing config.
  • Session Context Protocol — context.md for cross-session state awareness.
  • Plugin & Marketplace Distribution — Self-contained deployment formats.

Changed

  • Constitution sharpening: 55% token reduction by removing LLM-native overlaps.

1.0.0 — 2026-02-01

Added

  • Initial public release on PyPI.
  • 9 agents, 13 commands, 3 skills, 6 constitution rules.
  • Full PDCA+ lifecycle.
  • pactkit.yaml config with selective deployment.

FAQ

Frequently asked questions about PactKit

On this page

2.1.1 — 2026-03-18AddedChangedFixed2.1.0 — 2026-03-17AddedFixed2.0.2 — 2026-03-161.6.9 — 2026-03-13Fixed1.6.8 — 2026-03-06Fixed1.6.7 — 2026-03-05AddedFixed1.6.6 — 2026-03-05Fixed1.6.5 — 2026-03-04Fixed1.6.4 — 2026-03-04ChangedAdded1.6.3 — 2026-03-03Fixed1.6.2 — 2026-03-03Added1.6.1 — 2026-03-03FixedChanged1.6.0 — 2026-02-28AddedFixed1.5.0 — 2026-02-27Added1.4.0 — 2026-02-26Added1.3.1 — 2026-02-25Fixed1.3.0 — 2026-02-24Added1.1.4 — 2026-02-24Added1.1.3 — 2026-02-24Fixed1.1.2 — 2026-02-14FixedAdded1.1.0 — 2026-02-13AddedChanged1.0.0 — 2026-02-01Added