메뉴
Kiloforge CLI tools reference and shared documentation hub. Lists available tools, provides runtime environment info, and hosts reference docs used by other kf-* skills.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Receive a track ID, validate it is an active unclaimed track, then implement it following the kiloforge workflow.
Product strategy advisor: research the codebase and competitive landscape to provide product design, branding, feature prioritization, and competitive analysis advice. Produces actionable reports to .agent/kf/_reports/product-advisor/ designed for handoff to /kf-architect.
Project architect: research the codebase and distill feature requests into well-scoped kiloforge tracks with specs and implementation plans. Splits large work into multiple tracks (including BE/FE splits). Merges track artifacts to the primary branch so developer workers can claim them.
Resolve git merge conflicts during push or pull sync operations. Fetches remote changes, merges, resolves conflicts (or escalates), and completes the sync.
Interactive project bootstrapper with platform-aware defaults. Guides users through project creation decisions, generates a blueprint, scaffolds the project, and invokes kf-setup with pre-populated answers.
Manage track lifecycle: archive, bulk-archive, compact, restore, delete, rename, and cleanup
| name | kf-bin |
| description | Kiloforge CLI tools reference and shared documentation hub. Lists available tools, provides runtime environment info, and hosts reference docs used by other kf-* skills. |
Reference for CLI tools installed to ~/.kf/bin/ and shared documentation used by other kf-* skills.
references/ (e.g., merge protocol, data guardian)All CLI tools require the Kiloforge venv at ~/.kf/.venv (auto-created during /kf-setup).
NEVER install packages globally. All dependencies go into ~/.kf/.venv only.
Scripts are activated via preflight, which every skill evals at startup:
eval "$(~/.kf/bin/kf-preflight.py)"
For platform-specific Python setup, see references/python-setup.md.
| Tool | Description |
|---|---|
kf-preflight.py | Pre-flight check: verifies metadata, sets PRIMARY_BRANCH |
kf-primary-branch.py | Resolves primary branch from config.yaml |
kf-track.py | Track registry (add, list, update, claim, deps, conflicts, spec) |
kf-track-content.py | Track content (init, show, spec fields, plan, task, progress) |
kf-merge.py | Merge protocol (lock, rebase, verify, merge, release) |
kf-merge-lock.py | Cross-worktree branch lock (acquire, release, heartbeat) |
kf-claim.py | Per-worktree track claim (acquire, release, list, find) |
kf-dispatch.py | Dispatch assignments for idle developer worktrees |
kf-worktree-env.py | Detect worktree context, export env vars |
kf-status.py | Full project status (workers, tracks, spec, dispatch) |
kf-install.py | Install/update CLI tools (venv, scripts, shebangs) |
kf-conductor.py | Tmux multi-agent orchestration (spawn, dispatch, status) |
| Document | Used by | Description |
|---|---|---|
references/merge-protocol.md | kf-architect, kf-developer | Lock → rebase → verify → merge protocol |
references/data-schema.md | all kf-* skills | Authoritative data schema for all .agent/kf/ files |
references/data-guardian.md | kf-repair, kf-validate | Corruption detection heuristics and response |
references/implement-workflow.md | kf-developer | TDD task execution loop details |
references/new-track-interactive.md | kf-architect | Interactive Q&A track creation flow |
references/bulk-archive.md | kf-manage | Bulk archive workflow |
references/compact-archive.md | kf-manage | Compact archive workflow |
references/cli-tools.md | (this skill) | Extended CLI tool descriptions |
references/python-setup.md | kf-setup | Platform-specific Python installation |
When invoked, display the tools table. If a tool name is given as argument:
~/.kf/bin/{tool}.py --help
If tools are not installed, suggest /kf-setup.