Update documentation for power_steering_checker refactoring and Copilot CLI support (#2911)

## Changes

### Power-Steering Documentation (docs/features/power-steering/README.md)
- Updated Architecture section to reflect modular 12-file package structure
- Added changelog entry for v0.10.0 (2026-03-07) with refactoring details
- Documented Copilot CLI transcript support
- Highlighted 76% LOC reduction (5,063 → 1,217 lines in largest module)
- Added module responsibility descriptions and cross-references

### API Reference (docs/reference/power-steering-checker-api.md)
- Added refactoring summary to Package Overview section
- Documented 191 tests passing (121 existing + 48 parser + 22 Copilot e2e)
- Noted CLAUDECODE environment variable fix for nested sessions
- Cross-referenced power_steering_checker package README

### Copilot CLI Integration (docs/COPILOT_CLI.md)
- Bumped version to 1.1.0 (from 1.0.0)
- Added new "Copilot CLI Transcript Support" section to ToC
- Documented auto-detection of Claude Code vs Copilot CLI transcript formats
- Explained module structure and testing coverage
- Highlighted benefits for Copilot CLI users (session completion validation)

## Context

Following Diátaxis framework:
- **Explanation**: Architecture changes in Power-Steering docs
- **Reference**: API updates in reference documentation
- **Tutorial**: Usage guidance in Copilot CLI integration docs

Based on merged PRs from 2026-03-06 to 2026-03-07:
- PR #2910: Major refactoring into modular package
- PR #2887: Bash template quoting fix
- PR #2886: JSON handling in quality-audit-cycle

Co-authored-by: Claude Documentation Agent <claude-agent@amplihack.github.io>
Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: 3 people

docs/COPILOT_CLI.md

@@ -1,15 +1,18 @@
 # GitHub Copilot CLI Integration with amplihack
 
-**Version**: 1.0.0
-**Status**: Complete Integration
-**Last Updated**: 2026-01-16
+**Version**: 1.1.0
+**Status**: Complete Integration (with Copilot CLI Transcript Support)
+**Last Updated**: 2026-03-07
 
 ## Overview
 
 This document describes the complete integration between GitHub Copilot CLI and the amplihack agentic coding framework. The integration provides Copilot users with access to amplihack's agents, skills, workflows, and MCP servers.
 
+**New in v1.1.0 (2026-03-07)**: Native Copilot CLI transcript support in Power-Steering checker. The checker now auto-detects and parses both Claude Code and GitHub Copilot CLI transcript formats (real `events.jsonl` format), enabling session completion validation across both platforms.
+
 ## Table of Contents
 
+- [Copilot CLI Transcript Support](#copilot-cli-transcript-support)
 - [Architecture](#architecture)
 - [Quick Start](#quick-start)
 - [Integration Components](#integration-components)
@@ -27,6 +30,89 @@ This document describes the complete integration between GitHub Copilot CLI and
 
 Copilot CLI agents are **authored by the amplihack project** and stored in `~/.amplihack/.claude/agents/amplihack/`. When you run `amplihack copilot`, the framework symlinks these agents into `.github/agents/` so GitHub Copilot CLI can discover them. You don't need to write agents yourself — amplihack provides 30+ specialized agents (architect, builder, reviewer, tester, security, etc.) that Copilot can delegate to.
 
+## Copilot CLI Transcript Support
+
+**New in v1.1.0 (2026-03-07)**: Power-Steering now natively supports GitHub Copilot CLI session transcripts.
+
+### What Changed
+
+The `power_steering_checker` package has been refactored from a monolithic 5,063-line file into 12 focused modules with automatic transcript format detection:
+
+- **Auto-Detection**: Automatically detects whether a transcript is from Claude Code or GitHub Copilot CLI
+- **Copilot CLI Format**: Parses real `events.jsonl` format used by GitHub Copilot CLI
+- **Backward Compatible**: All existing Claude Code transcripts continue to work
+- **Tested**: 48 new parser tests + 22 Copilot CLI end-to-end tests (verified against 5 real Copilot sessions)
+
+### How It Works
+
+```
+Session Transcript → Transcript Parser → Power-Steering Checker
+                            ↓
+                   Auto-detect format:
+                   - Claude Code JSONL
+                   - Copilot CLI events.jsonl
+                            ↓
+                   Parse appropriately
+                            ↓
+                   Validate session completion
+```
+
+### Key Features
+
+1. **Format Auto-Detection**: No configuration needed - the parser detects the format automatically
+2. **SDK Call Safety**: CLAUDECODE environment variable properly unset to prevent nested session errors
+3. **Progress Tracking**: Works with both transcript formats for session completion validation
+4. **Error Resilience**: Fail-open design ensures checker never blocks due to parsing errors
+
+### Module Structure
+
+The refactored checker is organized into specialized modules:
+
+- `main_checker.py` — Orchestration + public API (1,217 lines, 76% reduction)
+- `transcript_parser.py` — Format detection + parsing (both Claude Code and Copilot CLI)
+- `session_detection.py` — Session type classification
+- `considerations.py` — Check configuration + evaluation
+- `sdk_calls.py` — Claude SDK integration + parallel analysis
+- `progress_tracking.py` — State persistence + redirect records
+- `result_formatting.py` — Output generation
+- Plus 5 check-specific modules
+
+See [power_steering_checker README](../.claude/tools/amplihack/hooks/power_steering_checker/README.md) for complete module documentation.
+
+### Testing
+
+All Copilot CLI transcript support is thoroughly tested:
+
+```bash
+# Run parser tests
+pytest .claude/tools/amplihack/hooks/power_steering_checker/tests/test_transcript_parser.py
+
+# Run Copilot CLI integration tests
+pytest .claude/tools/amplihack/hooks/tests/test_power_steering_copilot_cli.py
+
+# Total test coverage
+# - 121 existing tests (backward compatibility)
+# - 48 parser tests (format detection + parsing)
+# - 22 Copilot CLI e2e tests (real session validation)
+# = 191 tests passing
+```
+
+### Benefits for Copilot CLI Users
+
+1. **Session Completion Validation**: Power-Steering now works in Copilot CLI sessions
+2. **Quality Enforcement**: Same 21 considerations apply (TODOs, tests, CI, PR quality, etc.)
+3. **No Configuration**: Auto-detection means zero setup required
+4. **Cross-Platform**: Same checker logic works in both Claude Code and Copilot CLI
+
+### Migration Notes
+
+**No action required** - if you're already using amplihack with Copilot CLI, the transcript support is automatically enabled. The checker will:
+
+1. Detect you're using Copilot CLI (via transcript format)
+2. Parse the `events.jsonl` format correctly
+3. Apply the same 21 considerations as Claude Code
+4. Provide session completion validation
+
 ## Architecture
 
 ### Directory Structure

docs/features/power-steering/README.md

@@ -423,7 +423,20 @@ gh pr view --json statusCheckRollup
 ```
 .claude/tools/amplihack/
 ├── hooks/
-│   ├── power_steering_checker.py      # Core checker logic
+│   ├── power_steering_checker/        # Modular checker package
+│   │   ├── __init__.py                # Public API re-exports
+│   │   ├── main_checker.py            # PowerSteeringChecker orchestration (1,217 lines)
+│   │   ├── considerations.py          # Dataclasses + ConsiderationsMixin
+│   │   ├── sdk_calls.py               # SdkCallsMixin + SDK integration
+│   │   ├── progress_tracking.py       # ProgressTrackingMixin + state I/O
+│   │   ├── result_formatting.py       # ResultFormattingMixin + output generation
+│   │   ├── checks_ci_pr.py            # CI/PR-specific checks
+│   │   ├── checks_docs.py             # Documentation checks
+│   │   ├── checks_quality.py          # Code quality checks
+│   │   ├── checks_workflow.py         # Workflow adherence checks
+│   │   ├── session_detection.py       # Session type detection
+│   │   ├── transcript_parser.py       # Transcript parsing (Claude Code + Copilot CLI)
+│   │   └── transcript_helpers.py      # Transcript utility functions
 │   ├── power_steering_state.py        # State management
 │   └── templates/
 │       └── power_steering_prompt.txt  # User-facing messages
@@ -432,6 +445,13 @@ gh pr view --json statusCheckRollup
     └── USER_PREFERENCES.md            # User preferences
 ```
 
+**Architecture Highlights**:
+- **Modular Design**: Split from monolithic 5,063-line file into 12 focused modules (largest: 1,217 lines)
+- **Backward Compatible**: All existing imports continue to work via `__init__.py` re-exports
+- **Copilot CLI Support**: Auto-detects and parses both Claude Code and GitHub Copilot CLI transcripts (real `events.jsonl` format)
+- **Import-Time Safe**: CLAUDECODE environment variable unset to prevent nested session errors in SDK calls
+- **Independently Testable**: 191 unit/integration tests (121 existing + 48 parser + 22 Copilot e2e)
+
 ### Checker Methods
 
 | Method                       | Purpose                 | Evidence              |
@@ -444,6 +464,15 @@ gh pr view --json statusCheckRollup
 
 **Generic checker**: For custom considerations, uses keyword extraction and transcript search.
 
+**Module Responsibilities**:
+- `considerations.py` — Data models + consideration loading/evaluation
+- `sdk_calls.py` — Claude SDK integration + parallel analysis + timeouts
+- `progress_tracking.py` — State persistence + redirect records + compaction
+- `result_formatting.py` — Text formatting + output generation
+- `main_checker.py` — Orchestration + public API
+
+See [power_steering_checker package README](../../../.claude/tools/amplihack/hooks/power_steering_checker/README.md) for detailed module documentation.
+
 ### State Management
 
 Power-Steering maintains minimal state:
@@ -505,7 +534,33 @@ Power-Steering maintains minimal state:
 
 ## Changelog
 
-### v0.10.0 (Planned)
+### v0.10.0 (2026-03-07)
+
+**Refactored** (PR #2910):
+
+- **Modular Architecture**: Split monolithic `power_steering_checker.py` (5,063 lines) into 12 focused modules
+  - Largest module: `main_checker.py` at 1,217 lines (76% reduction)
+  - Improved maintainability and testability
+  - All existing imports remain backward compatible via `__init__.py` re-exports
+- **Copilot CLI Support**: Auto-detection and parsing of GitHub Copilot CLI transcripts
+  - Supports real `events.jsonl` format
+  - Verified against 5 real Copilot CLI sessions
+  - 48 new parser tests + 22 Copilot e2e tests
+- **SDK Integration Fix**: CLAUDECODE environment variable now properly unset to prevent nested session errors
+  - Affects all Claude SDK subprocess calls
+  - Applied to both `.claude/` and `amplifier-bundle/` copies
+
+**Testing**:
+
+- 191 unit/integration tests passing (121 existing + 48 parser + 22 Copilot e2e)
+- Quality audit cycle completed (3-agent validation)
+
+**Fixed** (PR #2887, #2886):
+
+- Bash template quoting in quality-audit-cycle (double-quote escaping issue)
+- JSON-as-commands execution in verify-fixes step
+
+### v0.9.2 (Planned)
 
 **Added**:
 

docs/reference/power-steering-checker-api.md

@@ -14,7 +14,14 @@ Complete API reference for the `power_steering_checker` package.
 .claude/tools/amplihack/hooks/power_steering_checker/
 ```
 
-It is structured as five focused modules assembled by a re-exporting `__init__.py` that preserves full backward compatibility with the previous single-file layout.
+**Recent Refactoring (v0.10.0, 2026-03-07)**: Split from a monolithic 5,063-line `power_steering_checker.py` into 12 focused modules (largest: 1,217 lines). The refactoring includes:
+- Modular architecture with clear separation of concerns
+- Copilot CLI transcript support (auto-detects both Claude Code and GitHub Copilot CLI formats)
+- CLAUDECODE environment variable properly unset to prevent nested session errors
+- 191 tests passing (121 existing + 48 parser + 22 Copilot e2e)
+- Full backward compatibility via re-exporting `__init__.py`
+
+See [power_steering_checker package README](../../.claude/tools/amplihack/hooks/power_steering_checker/README.md) for module details.
 
 ---