Skip to content

Feat/sdk server improvements#2

Merged
ukjaiswal merged 10 commits intomainfrom
feat/sdk-server-improvements
Feb 20, 2026
Merged

Feat/sdk server improvements#2
ukjaiswal merged 10 commits intomainfrom
feat/sdk-server-improvements

Conversation

@ukjaiswal
Copy link
Member

No description provided.

Uttam Jaiswal added 10 commits February 20, 2026 07:34
Critical fix:
- Add explicit file handler for logging (prevent stderr pollution)
- This was likely causing connection failures with Claude Code

New tools:
- get_practice_summary: Get first ~500 chars for quick reference
- search_practices: Search by keyword in name/content

Enhancements:
- list_practices now includes metadata (name, title, size)
- Better logging with content sizes
- Extract titles from markdown headings
- Sort practice/template lists
- Log file path in startup

Changes:
- Lines: 237 → 337 (+100 lines)
- Tools: 5 → 7 (+2 new tools)
- Now matches dev-kit stability patterns
Group 01: Workflow & Processes (3 practices)
- 01-01-session-continuity (Claude session management)
- 01-02-task-tracking (TODO tracking)
- 01-03-efficiency-guidelines (Best practices, anti-patterns)

Group 02: Version Control & Project Management (2 practices)
- 02-01-git-practices (Git workflows, branching)
- 02-02-issue-tracking (Issue management, TRACKER)

Group 03: Infrastructure & Configuration (3 practices)
- 03-01-configuration-management (Multi-env, infrastructure config)
- 03-02-air-gapped-workflow (Kubernetes air-gapped deployment)
- 03-03-standard-workflow (Non-air-gapped deployment)

Group 04: Documentation Standards (3 practices)
- 04-01-documentation-standards (General doc guidelines)
- 04-02-readme-maintenance (README specific)
- 04-03-runbook-documentation (Operational docs)

Benefits:
- GG-SS format enables hierarchical organization
- Grouped by function for better discoverability
- Consistent with dev-kit pattern
- Preserves git history via git mv
Apply GG-SS pattern to package structure to match root practices/
Ensures consistency between development and installed package
- REORGANIZATION-PROPOSAL.md: Documents GG-SS restructuring rationale
- uv.lock: Reproducible dependency management
- Add Group 01-04 headers with descriptions
- Update practice list with new GG-SS prefixed names
- Update architecture section with new filenames
- Maintain all existing descriptions and markers
Replace old practice names with new GG-SS prefixed names in:
- Examples and usage instructions
- File listings and references
- Command examples
- Added detailed CHANGELOG entry for v1.4.0
- Documented critical MCP server stability fix (logging to file)
- Documented GG-SS reorganization with 4 groups
- Documented 2 new MCP tools and enhanced list_practices
- Updated version numbers across all files:
  - pyproject.toml: 1.3.1 → 1.4.0
  - src/__init__.py: 1.3.1 → 1.4.0
  - src/__main__.py: 1.2.0 → 1.4.0
- Fixed health-check.sh duplicate entry (removed old issue-tracking.md)
- Added comprehensive upgrade guide from 1.3.1 to 1.4.0
- Updated version history table with v1.4.0 entry

Breaking changes: Practice filenames changed (GG-SS prefixes)
Impact: Server stability significantly improved, better discoverability
- Added naming pattern explanation: GG-SS-practice-name
- Documented GG = Group ID (01-04) for functional category
- Documented SS = Sequence ID for order within group
- Added Group Legend with all 4 groups and their meanings:
  - 01 = Workflow & Processes
  - 02 = Version Control & PM
  - 03 = Infrastructure & Config
  - 04 = Documentation Standards
- Included example: 03-02-air-gapped-workflow
- Makes GG codes easily discoverable for users
@ukjaiswal ukjaiswal merged commit 34ca572 into main Feb 20, 2026
8 checks passed
@ukjaiswal ukjaiswal deleted the feat/sdk-server-improvements branch February 20, 2026 02:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant