Skip to content
/

ContextKit

contextkit · FlineDev/ContextKit · ★ 169 · last commit 2026-03-10

Primitive shape 29 total
Commands 20 Subagents 9
00

Summary

ContextKit — Summary

ContextKit is a Claude Code slash-command system by FlineDev implementing a 4-phase spec-driven development workflow for iOS/macOS Swift development. It ships commands for business spec creation, technical architecture research, numbered implementation task generation, supervised development execution, and backlog management — all built around a Context/Features/ directory structure that persists specs across sessions.

Important: ContextKit is marked "no longer actively maintained" in its README as of March 2026, with features evolved into PlanKit (a lighter plugin-based successor). Analysis is of the frozen 0.2.0 state.

Problem it solves: AI assistants are reactive — they wait for step-by-step instructions instead of understanding the bigger picture. ContextKit gives the AI planning intelligence to understand intent upfront, break down features systematically, and execute with specialized quality agents (accessibility, localization, code debt, error handling) without constant steering.

Distinctive trait: iOS/macOS/Swift specialization — the technical architecture phase explicitly includes "Swift/SwiftUI patterns and architectural decisions, Accessibility, localization, and privacy considerations." The quality agents (check-accessibility.md, check-localization.md, check-modern-code.md) are Swift-ecosystem-specific, making this the most domain-specialized framework in this batch.

Differs from seeds: Most similar to kiro (spec lifecycle with requirements/design/tasks phases and approval gates) and openspec (command-per-phase workflow) but with a Swift/iOS domain focus rather than general-purpose development. Unlike kiro which uses an IDE fork, ContextKit uses standard Claude Code slash-commands. The numbered S001-S999 task system resembles taskmaster-ai's task numbering but operates on markdown files rather than a JSON database.

01

Overview

ContextKit — Overview

Origin

Published by FlineDev on GitHub. 169 stars, 1 contributor (Cihat Gündüz, iOS developer). MIT license. Last commit: 2026-03-10. Language: Shell (installer). Status: No longer actively maintained — superseded by PlanKit.

Philosophy

"The real problem: AI assistants are reactive, not proactive. You have to spoon-feed them every single step... You're managing the AI instead of collaborating with it."

"The solution: ContextKit gives AI the planning intelligence to understand your project, suggest the right technical approach, break down features systematically, and guide you through proven development phases."

"And you stay in control: ContextKit enables AI autonomy at the right moments while keeping you in strategic control. You review and approve the spec, tech decisions, and implementation plan at key checkpoints."

Domain Focus

Explicitly iOS/macOS Swift development:

  • Technical architecture phase includes Swift/SwiftUI patterns, Accessibility, Localization, Privacy
  • Quality agents: check-accessibility.md, check-localization.md, check-modern-code.md
  • Release commands: /ctxk:impl:release-app (AppStore) and /ctxk:impl:release-package (Swift packages)
  • settings.json configured to use Sonnet model (sufficient quality while reducing 5h-limit risk)

Custom Status Line

ContextKit configures a custom Claude Code statusline:

5h-Usage: 73% (1.4h left) | Chat: ▓▓▓▓▓▓░░░░ 64% (128k/200k)

Migration Note

Per README (March 2026): "ContextKit is no longer actively maintained. Its planning features have evolved into PlanKit — a lighter, plugin-based system that integrates directly with Claude Code's plugin marketplace."

02

Architecture

ContextKit — Architecture

Distribution

  • Type: Standalone repo with bash installer
  • License: MIT
  • Language: Shell (installer), Markdown (commands/agents)

Install Method

curl -fsSL https://raw.githubusercontent.com/FlineDev/ContextKit/main/install.sh | bash

Then in Claude Code:

/ctxk:proj:init

Directory Tree

ContextKit/
├── Templates/
│   ├── Agents/              # 9 subagent files
│   │   ├── build-project.md
│   │   ├── check-accessibility.md
│   │   ├── check-code-debt.md
│   │   ├── check-error-handling.md
│   │   ├── check-localization.md
│   │   ├── check-modern-code.md
│   │   ├── commit-changes.md
│   │   ├── run-specific-test.md
│   │   └── run-test-suite.md
│   ├── Commands/
│   │   ├── bckl/            # Backlog commands
│   │   ├── impl/            # Implementation commands
│   │   ├── plan/            # Planning commands
│   │   └── proj/            # Project commands
│   ├── Backlog/             # Backlog templates
│   ├── Contexts/            # Context file templates
│   ├── Features/            # Feature spec templates (Spec.md, Tech.md, Steps.md)
│   ├── Formatters/          # Output format templates
│   ├── Guidelines/          # Project guidelines templates
│   ├── Scripts/             # Shell scripts
│   └── settings.json        # Claude Code settings (Sonnet model, custom statusline)
├── install.sh
└── CLAUDE.md / AGENTS.md

Project-Level Files (after /ctxk:proj:init)

project/
├── Context.md               # Project context (required by all commands)
├── Context/
│   └── Features/
│       ├── 001-FeatureName/ # Full feature folder (Spec.md, Tech.md, Steps.md)
│       └── 002-SmallFix.md  # Quick task (single file)
└── Backlog/                 # Ideas, bugs (priority-sorted)

Required Runtime

  • bash
  • Claude Code
03

Components

ContextKit — Components

Commands (slash-commands, ~20)

Project Management

Command Purpose
/ctxk:proj:init Initialize ContextKit in project (auto-detects type)
/ctxk:proj:init-workspace Configure team/client standards
/ctxk:proj:migrate Upgrade to latest ContextKit version

Systematic Feature Planning (Full Workflow)

Command Purpose
/ctxk:plan:1-spec Business requirements, user stories, acceptance criteria, scope boundaries
/ctxk:plan:2-research-tech Technical architecture with constitutional compliance
/ctxk:plan:3-steps Numbered S001-S999 implementation tasks with parallel execution markers

Quick Workflow

Command Purpose
/ctxk:plan:quick Single-file planning with interactive validation for smaller tasks

Implementation

Command Purpose
/ctxk:impl:start-working Begin development with context-aware guidance + quality agents
/ctxk:impl:commit-changes Commit with smart message generation
/ctxk:impl:release-app Release to AppStore (iOS/macOS)
/ctxk:impl:release-package Publish Swift package

Backlog Management

Command Purpose
/ctxk:bckl:add-idea Add feature ideas with evaluation framework
/ctxk:bckl:add-bug Add bug with impact assessment
/ctxk:bckl:prioritize-ideas Prioritize ideas with binary search evaluation
/ctxk:bckl:prioritize-bugs Prioritize bugs with binary search evaluation
/ctxk:bckl:remove-idea Remove completed/cancelled idea
/ctxk:bckl:remove-bug Remove resolved bug

Subagents / Quality Agents (9)

Agent Purpose
build-project Build the Xcode project
check-accessibility iOS/macOS accessibility audit
check-code-debt Technical debt detection
check-error-handling Error handling completeness
check-localization Localization completeness
check-modern-code Modern Swift/SwiftUI patterns
commit-changes Structured commit message creation
run-specific-test Run a specific test case
run-test-suite Run full test suite

Template Files

Category Files
Features Spec.md, Tech.md, Steps.md (full workflow)
Feature single .md file (quick workflow)
Contexts Context.md project template
Backlog Ideas.md, Bugs.md
05

Prompts

ContextKit — Prompt Excerpts

Excerpt 1: /ctxk:plan:1-spec Command — Phase 0 Customization Read Pattern

# Create Feature Specification
<!-- Template Version: 15 | ContextKit: 0.2.0 | Updated: 2025-12-03 -->

## Execution Flow (main)

### Phase 0: Check Customization

0. **Read the "👩‍💻 DEVELOPER CUSTOMIZATIONS" section**
   - Use `Grep` tool to find the start of the section
   - Read everything below that line contained in this document til the end of the file
   - Make sure to consider what was said there with high priority
   - If anything conflicts with the rest of the workflow, prioritize the "developer customizations"

### Phase 1: Setup Validation & Prerequisites

1. **Check Project Setup**
   - Use `Glob` tool to verify Context.md exists: `Glob . Context.md`
   - If Context.md missing:
     ```
     ❌ ContextKit not initialized in this project!
     Run /ctxk:proj:init first...
     ```
     → END (exit with error)

### Phase 2: Interactive Feature Definition & Naming

2. **Check Git Status**
   ```bash
   git status --porcelain || echo "⚠️ Git not available"
  • If uncommitted changes exist → Warning + AskUserQuestion

**Prompting technique:** Template version stamping (`Template Version: 15 | ContextKit: 0.2.0`) combined with a "Phase 0 read customization" pattern. By making the first phase always read developer customizations, the framework ensures project-specific overrides take precedence over template defaults — without requiring the developer to edit the template file. The versioned templates are managed by `caliber update` / `faf migrate`-style update commands.

---

## Excerpt 2: Feature Spec Structure — What Phase 1 Produces

The `/ctxk:plan:1-spec` command creates `Spec.md` with:

```markdown
# Feature: [Feature Name]

## User Stories
- As a [user], I want [goal] so that [reason]

## Acceptance Criteria
- [ ] [Specific, measurable criterion]

## Success Metrics
- [Quantifiable metric]

## Uncertainty Markers (AI must not guess)
- [Things not yet decided]

## Scope Boundaries
### In Scope
- [Explicitly included]

### Out of Scope
- [Explicitly excluded]

Prompting technique: Scope boundary explication. The explicit "Out of Scope" section is the key quality mechanism — forcing both human and AI to enumerate what will NOT be built prevents scope creep during implementation. The "Uncertainty Markers" section acknowledges that some decisions are deferred, preventing the AI from making unchecked architectural choices.

09

Uniqueness

ContextKit — Uniqueness & Positioning

Differs From Seeds

Most similar to kiro (Archetype 5 — spec lifecycle with phased spec files) and openspec (Archetype 2 — command-per-phase workflow). Like kiro, ContextKit uses a Spec.md / Tech.md / Steps.md artifact structure; unlike kiro, it runs on standard Claude Code slash-commands rather than a proprietary IDE. Like openspec, it has one command per workflow phase; unlike openspec, the commands produce persistent artifact files rather than in-session plans.

The domain specialization (iOS/macOS Swift) is unique in the seed corpus and in this batch. No other framework addresses Xcode/AppStore-specific release workflows.

Status: Archived / Superseded

The README's deprecation notice is significant: "no longer actively maintained, evolved into PlanKit." For researchers, this means the framework represents a design iteration that the author themselves found insufficient — the evolution to PlanKit (plugin-based, lighter) is informative about what didn't work.

Key pain points implied by the migration:

  • The bash installer + template system was harder to update than a plugin marketplace
  • The command namespace /ctxk:* was more cumbersome than plugin-managed commands

Observable Failure Modes

  • Template version mismatch: each command has a Template Version: N comment; if templates are outdated, behavior changes but the agent doesn't know which version it has
  • Context.md presence check is the only safety gate — if the file is present but empty or wrong, commands proceed with bad context
  • Swift-specific quality agents are useless for non-Swift projects (this is documented: the framework is explicitly iOS-focused)
  • Backlog binary-search prioritization is novel but adds workflow friction

Relationship to faf-cli

The faf conductor command in faf-cli references "Conductor integration" — ContextKit has no known connection to faf-cli's Conductor feature. Separate systems.

04

Workflow

ContextKit — Workflow

Full Feature Workflow (4 phases)

Phase Command Artifact
1. Business Spec /ctxk:plan:1-spec Context/Features/NNN-FeatureName/Spec.md
2. Technical Architecture /ctxk:plan:2-research-tech Context/Features/NNN-FeatureName/Tech.md
3. Implementation Tasks /ctxk:plan:3-steps Context/Features/NNN-FeatureName/Steps.md (S001-S999 numbered)
4. Development /ctxk:impl:start-working Code changes + quality agent results

Quick Workflow

Phase Command Artifact
Plan + Execute /ctxk:plan:quick Context/Features/NNN-SmallFix.md

Approval Gates

Gate When
Feature naming confirmation (interactive) Start of /ctxk:plan:1-spec
Uncommitted changes warning Start of /ctxk:plan:1-spec
Understanding confirmation /ctxk:plan:quick (interactive validation)
Spec review Between phases 1 and 2
Tech review Between phases 2 and 3
Steps review Between phases 3 and implementation

Feature Directory Naming

Sequential numbering: 001-FeatureName/ (full), 002-SmallFix.md (quick). Mixed in Context/Features/ directory — folders for full features, files for quick tasks.

When to Use Full vs Quick

Use Quick Use Full
Bug fixes New major features
Smaller improvements Multi-component changes
Refactoring Unclear requirements
Focused changes Complex architectural decisions
Experiments Team review required
06

Memory Context

ContextKit — Memory & Context

State Storage

File Purpose
Context.md Project-level context (required by all commands — presence check is the first thing every command does)
Context/Features/NNN-*/Spec.md Business requirements per feature
Context/Features/NNN-*/Tech.md Technical architecture per feature
Context/Features/NNN-*/Steps.md Numbered implementation tasks per feature
Backlog/Ideas.md Prioritized feature ideas
Backlog/Bugs.md Prioritized bug reports

Cross-Session Handoff

The Context/Features/ directory structure persists specs across sessions. The /ctxk:impl:start-working command reads the feature's Spec.md, Tech.md, and Steps.md to restore context after a session break.

Context Compaction Guidance

The README explicitly advises disabling Claude Code's auto-compact: "Type /config in Claude and set 'Auto-compact' to false. Auto-compact triggers at ~85% context usage, often interrupting you when nearly finished with a task." Manual start of new chats + /ctxk:impl:start-working for resumption is the recommended pattern.

Custom Status Line

The settings.json configures a context usage display:

5h-Usage: 73% (1.4h left) | Chat: ▓▓▓▓▓▓░░░░ 64% (128k/200k)

This helps users manually manage their context usage rather than relying on auto-compact.

07

Orchestration

ContextKit — Orchestration

Multi-Agent

Yes — 9 named quality agents run during /ctxk:impl:start-working.

Orchestration Pattern

Sequential with specialized subagents at the implementation phase:

  1. Main agent implements within approved technical framework
  2. Quality agents run checks autonomously: accessibility, localization, code debt, error handling, modern code patterns
  3. Test agents run test suite

Subagent Definition Format

Persona-md (each agent is a markdown file describing its role and process).

Isolation

None — all agents work on the same working directory.

Execution Mode

Interactive-loop (multi-phase with user approval gates between phases).

Multi-Model

No — all agents use Claude Code's configured model (settings.json specifies Sonnet as default).

Prompt Chaining

Yes — the spec workflow is a chain: Phase 1 Spec.md → Phase 2 Tech.md (reads Spec.md) → Phase 3 Steps.md (reads Spec.md + Tech.md) → Implementation (reads all three).

08

Ui Cli Surface

ContextKit — UI / CLI Surface

CLI Binary

None. Installed via bash script, operates entirely through Claude Code slash-commands.

Local UI

None.

Claude Code Integration

All interaction via /ctxk:* slash-commands. Custom settings.json configures:

  • Model: Sonnet (default override)
  • Custom statusline: context usage display
  • Hooks: none (no hooks.json)

Observability

Custom statusline shows real-time context window usage and 5-hour Claude limit. No audit log.

Related frameworks

same archetype · same primary tool · same memory type

Claude-Flow / Ruflo ★ 55k

Eliminates single-agent context limits and sequential bottlenecks by orchestrating fault-tolerant swarms of specialized AI agents…

Hermes Agent (NousResearch) ★ 168k

Self-improving personal AI agent with closed learning loop, 7 terminal backends, and messaging gateway — not tied to any AI…

OpenCode ★ 165k

Terminal-first AI coding agent with multi-model routing, native desktop app, and a typed .opencode/ configuration system for…

OpenHands ★ 75k

Open-source AI software development platform (open-source Devin alternative) with Docker sandbox isolation, 77.6% SWE-bench…

DeerFlow ★ 70k

Long-horizon superagent that researches, codes, and creates by orchestrating parallel sub-agents with isolated contexts in Docker…

oh-my-openagent (omo) ★ 60k

Multi-provider AI agent orchestration for OpenCode: escape vendor lock-in by routing Sisyphus (Claude/Kimi/GLM) and Hephaestus…