### Windows Installation Steps and Post-Installation Actions

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/README.md

Detailed step-by-step guide for installing KFG on Windows, including cloning the repository, running the PowerShell installer, and restarting the terminal. It also outlines what the installer does, such as creating junctions, installing Claude Code, and adding custom functions.

```powershell
# 1. Sklonuj repo
git clone https://github.com/kmylpenter/KFG.git
cd KFG

# 2. Uruchom instalator
.\desktop\install.ps1

# 3. Restart terminala (ładuje nowy profil PowerShell)

# 4. Test - uruchom Claude
cc
```

--------------------------------

### VS Code Extension Setup and Build Commands

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/vscode/extensions/PLAN_DynamicTerminalSaver.md

Commands required to set up, compile, and package a VS Code extension. This includes installing dependencies, compiling TypeScript, and creating a .vsix file for local installation.

```bash
npm install
npm run compile
vsce package
```

--------------------------------

### VS Code Extension Initialization and Dependencies

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/vscode/extensions/PLAN_DynamicTerminalSaver.md

Steps to initialize a new VS Code extension project and install necessary development dependencies. This involves using npm for project setup and dependency management.

```bash
npm init
npm install @types/vscode typescript --save-dev
```

--------------------------------

### Install LFG via Git Submodule

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/docs/LFG-vs-Continuous-Claude-Comparison.md

Installation scripts for LFG on Unix-based systems and Windows PowerShell, automating log structure and rule setup.

```bash
# Bash/Mac/Linux
git submodule add -b main \
  https://github.com/clark-mackey/log-file-genius.git \
  .log-file-genius && \
  ./.log-file-genius/product/scripts/install.sh
```

```powershell
# PowerShell/Windows
git submodule add -b main `
  https://github.com/clark-mackey/log-file-genius.git `
  .log-file-genius; `
  .\.log-file-genius\product\scripts\install.ps1
```

--------------------------------

### Install CCv2 System

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/docs/LFG-vs-Continuous-Claude-Comparison.md

Methods for installing CCv2 as a single project or as a global utility with per-project initialization.

```bash
# Opcja 1: Single Project
git clone https://github.com/parcadei/Continuous-Claude-v2.git
cd Continuous-Claude-v2
uv sync
claude

# Opcja 2: Global + Per-Project
./install-global.sh
cd any-project
~/.claude/scripts/init-project.sh
```

--------------------------------

### Install KFG CCv2 on Windows using PowerShell

Source: https://context7.com/kmylpenter/kfg-ccv2-installer-stable/llms.txt

This script installs the KFG CCv2 system on Windows. It checks for prerequisites like Node.js and Git, installs Claude Code, configures GitHub CLI, sets up directory structures, copies hooks and templates, and configures PowerShell profiles. After installation, a terminal restart is recommended.

```powershell
# Szybka instalacja - jedna komenda
git clone https://github.com/kmylpenter/KFG-CCv2-Installer-Stable.git
cd KFG-CCv2-Installer-Stable
powershell -ExecutionPolicy Bypass -File install-windows.ps1

# Po instalacji - restart terminala i test
cc  # Uruchomi Claude Code z pełną konfiguracją KFG

# Instalator wykonuje:
# [1/12] Sprawdzenie środowiska (PowerShell, Node.js, Git)
# [2/12] Instalacja Claude Code (npm install -g @anthropic-ai/claude-code)
# [3/12] Konfiguracja GitHub CLI (gh auth login)
# [4/12] Narzędzia visual validation (Playwright, ImageMagick, Python packages)
# [5/12] Konfiguracja Git (user.name, user.email, init.defaultBranch=main)
# [6/12] Tworzenie struktury katalogów (~/.claude/, ~/.templates/)
# [7/12] Kopiowanie hooków i reguł
# [8/12] Instalacja szablonów walidacji
# [9/12] Konfiguracja PowerShell profile (aliasy cc, p, np, gs)
# [10/12] Synchronizacja historii konwersacji (GitHub private repo)
# [11/12] Instalacja rozszerzeń VSCode
# [12/12] Finalizacja i weryfikacja
```

--------------------------------

### Install KFG Configuration

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/CLAUDE.md

Executes the installation script to merge base configurations and platform-specific overrides into the local environment. This script should be run from the root directory of the repository.

```bash
./install.sh
```

--------------------------------

### Android (Termux) Installation Script

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/README.md

Commands to install KFG on Android using Termux. This involves cloning the repository, making the installation script executable, and running it, followed by sourcing the bashrc file to apply changes.

```bash
git clone https://github.com/kmylpenter/KFG.git
cd KFG
chmod +x install.sh
./install.sh
source ~/.bashrc
```

--------------------------------

### Quick Installation for Windows, Linux, macOS, and Termux

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/README.md

Provides commands to clone the KFG repository and initiate the installation process on different operating systems. For Windows, it uses a PowerShell script, while for Linux/macOS/Termux, it uses a shell script.

```powershell
# Windows
git clone https://github.com/kmylpenter/KFG-CCv2-Installer-Stable.git
cd KFG-CCv2-Installer-Stable
powershell -ExecutionPolicy Bypass -File install-windows.ps1
```

```bash
# Linux/macOS/Termux
git clone https://github.com/kmylpenter/KFG-CCv2-Installer-Stable.git
cd KFG-CCv2-Installer-Stable
chmod +x install.sh
./install.sh
```

--------------------------------

### Install KFG Claude Code Environment

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/setup/INSTALL.md

Commands to clone the repository and execute the installation script on a fresh Termux instance.

```bash
pkg install git -y
git clone https://github.com/kmylpenter/Termux-CC.git
cd Termux-CC/setup
./install.sh
```

--------------------------------

### Install and Authenticate Claude Code

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/desktop/README.md

Installs the Claude CLI tool globally via npm and initiates the login process. Requires Node.js and npm to be installed on the system.

```bash
npm install -g @anthropic-ai/claude-code
claude login
```

--------------------------------

### Force Reinstall or Update Installation

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/setup/templates/log-file-genius/INSTALL.md

Runs the installation script with a force flag to overwrite existing configurations and reinstall AI rules.

```bash
./.log-file-genius/product/scripts/install.sh --force
```

```powershell
.\.log-file-genius\product\scripts\install.ps1 -Force
```

--------------------------------

### Install LFG in Existing Project

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/README.md

Command to initialize the Log File Genius system within an existing project directory.

```bash
cd projekt
lfg-install
```

--------------------------------

### Install KFG CCv2 on Linux/macOS/Android using Bash

Source: https://context7.com/kmylpenter/kfg-ccv2-installer-stable/llms.txt

This script installs the KFG CCv2 system on Unix-like systems, including Linux, macOS, and Android (via Termux). It automatically detects the platform and uses appropriate paths. Options include symlinking, copying files, forcing overwrites, and verification only. After installation, sourcing the bashrc file is necessary to activate aliases.

```bash
# Instalacja na Linux/macOS/Android (Termux)
git clone https://github.com/kmylpenter/KFG-CCv2-Installer-Stable.git
cd KFG-CCv2-Installer-Stable
chmod +x install.sh
./install.sh

# Opcje instalatora
./install.sh --symlink    # Domyślne: symlink ~/.claude/ -> KFG/.claude/
./install.sh --copy       # Kopiowanie zamiast symlink
./install.sh --force      # Nadpisz istniejące pliki
./install.sh --verify     # Tylko weryfikacja, bez instalacji

# Po instalacji
source ~/.bashrc
cc  # Uruchomi Claude Code

# Struktura po instalacji (Android/Termux):
# ~/.claude/              -> KFG/.claude/ (symlink)
# ~/.templates/           -> szablony walidacji
# ~/.bashrc               -> aliasy (p, np, cc, gs, gp, gl)
# ~/.tmux.conf            -> konfiguracja tmux
```

--------------------------------

### Install Playwright and Chromium

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/desktop/README.md

Installs the Playwright testing framework globally and downloads the Chromium browser binary. This is necessary for automated browser testing and screenshot capturing.

```bash
npm install -g playwright
npx playwright install chromium
```

--------------------------------

### CHANGELOG.md - Example Current Context Section

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/setup/templates/log-file-genius/product/docs/log_file_how_to.md

Provides an example of the 'Current Context' section in CHANGELOG.md, which must be kept up-to-date in multi-tenant development environments. It includes version, branch, phase, stack, objectives, and entry points.

```markdown
## Current Context

**Version:** v0.6.4
**Branch:** main
**Phase:** Pilot customer onboarding

**Stack:**
- Python 3.11+ (MCP server, tools, scripts)
- Supabase (PostgreSQL + RLS for multi-tenant analytics)
- Claude Desktop (MCP client)

**Current Objectives:**
- Onboard 10 pilot customers with existing skills
- Collect feedback data for analytics

**Entry Points:**
- MCP Server: `core/mcp-server/src/server.py`
- Tools: `core/mcp-server/src/tools/`
- Database: `core/database/schema.sql`
```

--------------------------------

### Initialize New Project Script

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/logs/CODEBASE.md

The `init-project.sh` script initializes a new project with a predefined structure, including directories for logs, configuration files, and a Git repository with a GitHub remote. It automates the setup process for new projects.

```bash
#!/bin/bash

# Description: Initializes a new project with full LFG.
# Usage: ~/.templates/init-project.sh

# Create directories
mkdir -p logs/adr/ screenshots/
mkdir -p .claude/rules/

# Create configuration files
touch .logfile-config.yml

# Initialize Git repository and add remote
git init
git remote add origin <github_remote_url>

echo "Project initialized successfully."
```

--------------------------------

### Template Usage Example

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/docs/AUTONOMOUS-LFG.md

Demonstrates how to use a validation template for a web frontend project. It shows the interaction between a user (Ty) and an AI assistant (Claude) to generate a validation file.

```bash
Ty: auto landing page --template=web-frontend

Claude:
1. Ładuję ~/.templates/validation/web-frontend.md
2. Kopiuję do ./VALIDATION.md
3. Dodaję specyficzne kryteria
4. Pracuję z checklistą
```

--------------------------------

### One-Command Installation for Log File Genius

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/setup/templates/log-file-genius/README.md

Installs Log File Genius into an existing project using a single command. It detects AI assistants, prompts for project profiles, creates log folder structures, and installs necessary templates and rules. Dependencies include Git and the respective shell environments (Bash/PowerShell).

```bash
git submodule add -b main \
  https://github.com/clark-mackey/log-file-genius.git \
  .log-file-genius && \
  ./.log-file-genius/product/scripts/install.sh
```

```powershell
git submodule add -b main `
  https://github.com/clark-mackey/log-file-genius.git `
  .log-file-genius; `
  .\.log-file-genius\product\scripts\install.ps1
```

--------------------------------

### VS Code Extension Local Installation

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/vscode/extensions/PLAN_DynamicTerminalSaver.md

Command to install a VS Code extension locally from a generated .vsix file. This is typically done after packaging the extension.

```bash
code --install-extension dynamic-terminal-saver-0.0.1.vsix
```

--------------------------------

### Install ImageMagick via Winget

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/desktop/README.md

Installs the ImageMagick suite on Windows using the Winget package manager. This is required for image processing tasks such as comparison.

```powershell
winget install ImageMagick.ImageMagick
```

--------------------------------

### Supported Comment Formats for Titles

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/vscode/extensions/clipboard-workflow-helper/README.md

Examples of how to define backup titles in different programming languages.

```javascript
// ==Save: Dodano walidację formularza==
```

```python
# ==Save: Fix bug w funkcji calculate==
```

```sql
-- ==Save: Nowa tabela users==
```

```html
<!-- ==Save: Redesign header== -->
```

--------------------------------

### Compile Project using npm

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/vscode/extensions/clipboard-workflow-helper/README.md

This snippet shows the commands to compile the project using npm. It involves navigating to the project directory, installing dependencies, and running the compile script.

```bash
cd .vscode/extensions/clipboard-workflow-helper
npm install
npm run compile
```

--------------------------------

### Install Log File Genius via Git Submodule

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/setup/templates/log-file-genius/INSTALL.md

Adds the Log File Genius repository as a git submodule and executes the installation script to set up project documentation and AI rules.

```bash
git submodule add -b main https://github.com/clark-mackey/log-file-genius.git .log-file-genius && ./.log-file-genius/product/scripts/install.sh
```

```powershell
git submodule add -b main `
  https://github.com/clark-mackey/log-file-genius.git `
  .log-file-genius; `
  .\.log-file-genius\product\scripts\install.ps1
```

--------------------------------

### DEVLOG.md - Update Format Example

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/setup/templates/log-file-genius/product/docs/log_file_how_to.md

Illustrates the recommended update format for DEVLOG.md, which uses a Situation/Challenge/Decision/Impact/Files structure for documenting completed work units and significant project events.

```markdown
```markdown
Situation/Challenge/Decision/Impact/Files structure
```
```

--------------------------------

### VS Code Extension Main File Example (extension.ts)

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/vscode/extensions/PLAN_DynamicTerminalSaver.md

A basic structure for the main extension file (extension.ts). It demonstrates how to register commands and manage terminal states using the VS Code API.

```typescript
import * as vscode from 'vscode';

export function activate(context: vscode.ExtensionContext) {
    let disposableSave = vscode.commands.registerCommand('Dynamic Terminal Saver: Save Terminal State', () => {
        // Implementation for saving terminal state
        vscode.window.showInformationMessage('Terminal state saved!');
    });

    let disposableRestore = vscode.commands.registerCommand('Dynamic Terminal Saver: Restore Terminal State', () => {
        // Implementation for restoring terminal state
        vscode.window.showInformationMessage('Terminal state restored!');
    });

    let disposableClear = vscode.commands.registerCommand('Dynamic Terminal Saver: Clear Saved State', () => {
        // Implementation for clearing saved state
        vscode.window.showInformationMessage('Saved terminal state cleared!');
    });

    context.subscriptions.push(disposableSave, disposableRestore, disposableClear);
}

export function deactivate() {}
```

--------------------------------

### Example Markdown Status Update Output

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/setup/templates/log-file-genius/product/ai-rules/claude-code/status-update.md

An example of a completed status update using the defined markdown template. This illustrates how the dynamic information is populated for a project named 'Log File Genius'.

```markdown
📍 **Status Update - Log File Genius**

**Current State:**
- **Version:** v0.1.0-dev (pre-release)
- **Phase:** Foundation - Repository structure complete, ready for launch
- **Branch:** main

**Recent Progress:**
- ✅ Created README.md with quick start and migration guide
- ✅ Added CONTRIBUTING.md for community engagement
- ✅ Moved Augment rules into starter pack for better distribution

**Next Up:**
- Set up GitHub repository features (About, Topics, Template button)
- Create issue templates for bug reports and feature requests
- Consider GitHub Pages for documentation hosting

**Risks/Blockers:**
- None currently
```

--------------------------------

### LFG Configuration Profile

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/docs/LFG-vs-Continuous-Claude-Comparison.md

Example of the YAML configuration file used in LFG to define developer profiles and AI assistant settings.

```yaml
profile: solo-developer
ai_assistant: claude-code
```

--------------------------------

### Bash Installation Script for Dynamic Terminal Saver

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/vscode/extensions/dynamic-terminal-saver/DOKUMENTACJA.md

A bash script outlining the steps to install the Dynamic Terminal Saver extension locally. It involves navigating to the extension directory, installing dependencies, compiling TypeScript, packaging the extension using vsce, and then installing the generated VSIX file into VS Code.

```bash
cd .vscode/extensions/dynamic-terminal-saver
npm install
npm run compile
npx vsce package --allow-missing-repository
code --install-extension dynamic-terminal-saver-0.0.1.vsix --force
```

--------------------------------

### New Project (/np) Command

Source: https://context7.com/kmylpenter/kfg-ccv2-installer-stable/llms.txt

The '/np' command initiates a new project with the complete KFG structure, including a 'logs/' directory with essential documents, Git configuration, and optional GitHub repository setup. It automates the creation of STATE.md, CHANGELOG.md, CONTINUITY.md, and CLAUDE.md.

```bash
# Użycie w Claude Code:
> /np moj-projekt

# Claude wykonuje:

# 1. Git init + struktura katalogów
cd "D:\\Projekty StriX" && mkdir -p "moj-projekt" && cd "moj-projekt" && \
git init && mkdir -p logs/adr logs/archive logs/handoffs logs/screenshots

# 2. Tworzy pliki (równolegle):

# logs/STATE.md
```markdown
# Current State

**Last Updated:** 2026-01-10
**Updated By:** KFG init

---

## Active Work
- Nowy projekt - do zdefiniowania

## Blockers
- Brak

## Recently Completed
- ✅ Projekt zainicjalizowany z KFG (2026-01-10)

## Next Priorities
1. Zdefiniować cel projektu
2. Pierwszy feature
```

# logs/CHANGELOG.md
```markdown
# Changelog

## [Unreleased]

### Added
- Inicjalizacja projektu z KFG
```

# logs/CONTINUITY.md
```markdown
# Continuity Ledger

## Aktywna Sesja
**Data:** 2026-01-10
**Urządzenie:** PC
**Cel:** Nowy projekt
**Status:** IN_PROGRESS
```

# CLAUDE.md
```markdown
# moj-projekt

## KFG Commands
- "stan" → STATE + CONTINUITY
- "eos" → Zakończ sesję
```

# 3. Opcjonalnie GitHub (po pytaniu)
gh repo create "moj-projekt" --private --source=. --push

# Wynik:
✅ Projekt "moj-projekt" utworzony
Ścieżka: D:\\Projekty StriX\\moj-projekt
Struktura: logs/ (STATE, CHANGELOG, DEVLOG, CONTINUITY, adr/)
Powiedz "stan" aby zobaczyć status.

```

--------------------------------

### Initialize Project Script Updates (init-project.sh)

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/logs/ANALIZA-REGUL-LFG.md

This snippet shows the evolution of the init-project.sh script, illustrating changes in project initialization objectives from defining project goals to defining project architecture and reading LFG documentation. The script is present in multiple locations within the project.

```shell
PRZED (identyczne):
  DEVLOG: "Zdefiniować cele projektu"
  STATE:  "Zdefiniować cele projektu"

PO (różne poziomy):
  DEVLOG: "Zdefiniować architekturę projektu"
  STATE:  "Przeczytać dokumentację LFG"
```

--------------------------------

### Shortening Claude Rules (Markdown Example)

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/docs/CONTEXT-OPTIMIZATION-PLAN.md

This strategy involves shortening the content of rule files by replacing detailed instructions with concise references. The example shows a reduction from a lengthy file with examples to a brief file with a reference and key points, drastically cutting token usage.

```markdown
# autonomous.md (BEFORE: 515 linii, 4,500 tokens)

## EOS
See: ~/.claude/rules/autonomous.md#eos

# autonomous.md (AFTER: 50 linii, 400 tokens)

## EOS - FAST MODE
Target: <30s. Parallel: Write+Edit+Edit+Edit. Then: git add && commit && push.
```

--------------------------------

### Claude Code Agent and Summary File Examples

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/docs/analizakonwersacji.md

Examples of agent log entries and summary-only file entries used for context management.

```json
{
  "type": "user",
  "uuid": "warmup-123",
  "message": {
    "role": "user",
    "content": "Warmup"
  },
  "agentId": "a0f9d68"
}

{
  "type": "summary",
  "summary": "User worked on fixing authentication bug. Made changes to auth.py and tested login flow.",
  "leafUuid": "abc123-def456"
}
```

--------------------------------

### Custom Hook Example: Component Validation

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/docs/AUTONOMOUS-LFG.md

An example of a custom hook that matches edits to JSX component files and executes a specific validation script located at './scripts/validate-component.sh'.

```json
{
  "matcher": "Edit:src/components/*.jsx",
  "command": "./scripts/validate-component.sh"
}
```

--------------------------------

### Claude Code Conversation Entry Examples

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/docs/analizakonwersacji.md

Examples of user and assistant entries in the .jsonl conversation files, showing fields like uuid, timestamp, and message content.

```json
{
  "type": "user",
  "uuid": "abc123",
  "parentUuid": "def456",
  "timestamp": "2026-01-08T10:30:00.000Z",
  "sessionId": "session-xyz",
  "cwd": "D:\\Projekty\\MojProjekt",
  "message": {
    "role": "user",
    "content": "Napraw błąd w funkcji calculate()"
  }
}

{
  "type": "assistant",
  "uuid": "ghi789",
  "parentUuid": "abc123",
  "timestamp": "2026-01-08T10:30:05.000Z",
  "message": {
    "role": "assistant",
    "content": [
      {"type": "text", "text": "Sprawdzam funkcję calculate()..."},
      {"type": "tool_use", "name": "Read", "input": {"file_path": "src/calc.py"}}
    ],
    "model": "claude-sonnet-4-20250514",
    "stop_reason": "tool_use",
    "usage": {"input_tokens": 1500, "output_tokens": 200}
  }
}
```

--------------------------------

### Old Project (/op) Command - KFG Integration

Source: https://context7.com/kmylpenter/kfg-ccv2-installer-stable/llms.txt

The '/op' command integrates KFG structure into an existing project that lacks a 'logs/' directory. It analyzes the current project state by checking for common project files (package.json, requirements.txt, etc.) and reading the README.md to populate the KFG documentation.

```bash
# Użycie w Claude Code:
> /op nazwa-projektu

# Claude wykonuje:

# 1. Analiza projektu (bez Bash, tylko Glob/Read):
Glob("package.json")      # Wykrywa projekt Node.js
Glob("requirements.txt")  # Wykrywa projekt Python
Glob("Cargo.toml")        # Wykrywa projekt Rust
Glob("go.mod")            # Wykrywa projekt Go
Read("README.md")         # Pobiera opis projektu

```

--------------------------------

### PowerShell Profile Script Example

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/vscode/extensions/PLAN_DynamicTerminalSaver.md

An example of a PowerShell profile script that automatically runs a command or script (like 'claude') in every new PowerShell terminal session. This is useful for setting up development environments.

```powershell
# .claude/auto-claude.ps1
# This script is auto-run by the PowerShell profile.

# Example: Start a process or script
# Start-Process "claude"
```

--------------------------------

### LFG Multi-Agent Coordination via STATE.md

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/docs/LFG-vs-Continuous-Claude-Comparison.md

Demonstrates the manual coordination mechanism used in LFG through a centralized STATE.md file to track active work, blockers, and completed tasks.

```markdown
# STATE.md

## Active Work
- **Agent-1** (feature/auth): OAuth2 PKCE flow
- **Agent-2** (main): Payment bug fix

## Blockers
- DB migration needs DBA review (blocks Agent-1)

## Recently Completed
- ✅ OAuth2 implemented (Agent-1, 14:30)
```

--------------------------------

### Commit Message Format Examples (Text)

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/setup/templates/log-file-genius/CONTRIBUTING.md

This section provides examples of the recommended commit message format for contributions to Log File Genius. It follows a pattern of 'Type: Description' to categorize changes effectively.

```text
Add: New feature or file
Update: Changes to existing content
Fix: Bug fixes
Remove: Deleted files or features
Docs: Documentation-only changes

Examples:
- Add: Cursor starter pack with installation guide
- Fix: Broken links in migration guide
- Update: README with new token reduction metrics
- Docs: Clarify ADR creation process
```

--------------------------------

### Execute MCP Scripts via Harness

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/docs/LFG-vs-Continuous-Claude-Comparison.md

Demonstrates how to execute scripts outside of the LLM context using a harness to reduce token usage by avoiding full schema loading.

```bash
# Zamiast ładować pełny schemat narzędzia:
uv run python -m runtime.harness scripts/<script>.py

# Script wykonuje się poza kontekstem
# Tylko wynik wraca do Claude
```

--------------------------------

### Display Pre-Commit Checklist

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/setup/templates/log-file-genius/product/ai-rules/claude-code/log-file-maintenance.md

A template for displaying the mandatory pre-commit verification steps to the user.

```text
✅ Pre-Commit Checklist:
- [ ] CHANGELOG.md updated
- [ ] DEVLOG.md updated (if milestone)
- [ ] Validation run (if available)
- [ ] Planning files added to commit
- [ ] Ready to commit
```

--------------------------------

### Update Log File Genius

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/setup/templates/log-file-genius/README.md

Updates the Log File Genius installation to the latest version. This involves pulling the latest changes from the Git submodule and then re-running the installer script with the --force flag to ensure a smart merge that preserves customizations.

```bash
# Update source
cd .log-file-genius && git pull && cd ..

# Re-run installer (smart merge, preserves customizations)
./.log-file-genius/product/scripts/install.sh --force
```

--------------------------------

### Autonomous Task Definition

Source: https://github.com/kmylpenter/kfg-ccv2-installer-stable/blob/main/README.md

Example of defining an autonomous task for Claude with specific validation criteria.

```text
auto formularz kontaktowy

KRYTERIA:
- Walidacja email
- Submit do API
- Loading/success/error states
- Mobile responsive
```