kazuki nakai d5dfd7da21
refactor(docs): normalize documentation naming to lowercase for PEP8 compliance (#434)
* refactor(docs): rename directories to lowercase for PEP8 compliance

- Developer-Guide → developer-guide
- Getting-Started → getting-started
- Reference → reference
- Templates → templates
- User-Guide → user-guide
- User-Guide-jp → user-guide-jp
- User-Guide-kr → user-guide-kr
- User-Guide-zh → user-guide-zh

This change aligns with Python PEP8 package naming conventions.
All 43 files affected.

* refactor: rename root documentation files to lowercase

- CHANGELOG.md → changelog.md
- CODE_OF_CONDUCT.md → code_of_conduct.md
- CONTRIBUTING.md → contributing.md
- SECURITY.md → security.md

Aligns with Python package naming conventions (PEP8).
README files remain uppercase as per convention.

* refactor: move documentation files to docs/ for cleaner root

Moved OSS standard files to docs/:
- CHANGELOG.md → docs/CHANGELOG.md
- CODE_OF_CONDUCT.md → docs/CODE_OF_CONDUCT.md
- CONTRIBUTING.md → docs/CONTRIBUTING.md
- SECURITY.md → docs/SECURITY.md

Root now contains only essential files:
✓ README files (表紙: en, ja, kr, zh)
✓ LICENSE (法的要件)
✓ Build configs (pyproject.toml, setup.py, MANIFEST.in)
✓ VERSION

Rationale:
Cleaner root structure following modern Python project conventions.
All detailed documentation consolidated in docs/ directory.

* refactor: update documentation links after restructure

Auto-updated internal documentation links to reflect new structure:
- docs/ subdirectories now lowercase (PEP8)
- Root files moved to docs/
- All cross-references updated

This commit includes linter-generated link updates.

* chore(docs): keep OSS-standard uppercase root files (CHANGELOG, CODE_OF_CONDUCT, CONTRIBUTING, SECURITY)

* chore(docs): remove duplicated PR docs from repo root (moved under docs)

* docs: rename pm-agent-implementation-status.md -> PM_AGENT.md for clarity

* docs: update links to PM_AGENT.md after rename

---------

Co-authored-by: kazuki <kazuki@kazukinoMacBook-Air.local>
2025-10-15 21:07:39 +05:30

3.7 KiB

SuperClaude Development Tasks

Last Updated: 2025-10-14 Current Sprint: Phase 1 - Documentation Structure


🔥 High Priority (This Week: 2025-10-14 ~ 2025-10-20)

Phase 1: Documentation Structure

  • Create docs/development/ directory
  • Write ARCHITECTURE.md
  • Write ROADMAP.md
  • Write TASKS.md (this file)
  • Write PROJECT_STATUS.md
  • Write pm-agent-integration.md
  • Commit Phase 1 changes

PM Agent Mode

  • Design Session Lifecycle
  • Design PDCA Cycle
  • Update Commands/pm.md
  • Update Agents/pm-agent.md
  • Create PM_AGENT.md
  • Commit PM Agent Mode changes

📋 Medium Priority (This Month: October 2025)

Phase 2: Core Implementation

  • Implement superclaude/Core/session_lifecycle.py
  • Implement superclaude/Core/pdca_engine.py
  • Implement superclaude/Core/memory_ops.py
  • Write unit tests for PM Agent core
  • Update user-guide documentation

Testing & Validation

  • Create test suite for session_lifecycle
  • Create test suite for pdca_engine
  • Create test suite for memory_ops
  • Integration testing for PM Agent flow
  • Performance benchmarking

💡 Low Priority (Future)

Phase 3: Serena MCP Integration

  • Configure Serena MCP server
  • Test Serena connection
  • Implement memory operations
  • Test cross-session persistence

Phase 4: Documentation Strategy

  • Create docs/temp/ template
  • Create docs/patterns/ template
  • Create docs/mistakes/ template
  • Implement 7-day cleanup automation

Phase 5: Auto-Activation

  • Research Claude Code init hooks
  • Implement auto-activation
  • Test session start behavior
  • Performance optimization

🐛 Bugs & Issues

Known Issues

  • Serena MCP not configured (blocker for Phase 3)
  • Auto-activation hooks unknown (research needed for Phase 5)
  • Documentation directory structure missing (in progress)

Recent Fixes

  • PM Agent changes salvaged from ~/.claude directory (2025-10-14)
  • Git repository cleanup in ~/.claude (2025-10-14)

Completed Tasks

2025-10-14

  • Salvaged PM Agent mode changes from ~/.claude
  • Cleaned up ~/.claude git repository
  • Created PM_AGENT.md
  • Created docs/development/ directory
  • Wrote ARCHITECTURE.md
  • Wrote ROADMAP.md
  • Wrote TASKS.md

📊 Sprint Metrics

Current Sprint (Week 1)

  • Planned Tasks: 8
  • Completed: 7
  • In Progress: 1
  • Blocked: 0
  • Completion Rate: 87.5%

Overall Progress (Phase 1)

  • Total Tasks: 6
  • Completed: 3
  • Remaining: 3
  • On Schedule: Yes

🔄 Task Management Process

Weekly Cycle

  1. Monday: Review last week, plan this week
  2. Mid-week: Progress check, adjust priorities
  3. Friday: Update task status, prepare next week

Task Categories

  • 🔥 High Priority: Must complete this week
  • 📋 Medium Priority: Complete this month
  • 💡 Low Priority: Future enhancements
  • 🐛 Bugs: Critical issues requiring immediate attention

Status Markers

  • Completed: Task finished and verified
  • 🔄 In Progress: Currently working on
  • Pending: Waiting for dependencies
  • 🚫 Blocked: Cannot proceed (document blocker)

📝 Task Template

When adding new tasks, use this format:

- [ ] Task description
  - **Priority**: High/Medium/Low
  - **Estimate**: 1-2 hours / 1-2 days / 1 week
  - **Dependencies**: List dependent tasks
  - **Blocker**: Any blocking issues
  - **Assigned**: Person/Team
  - **Due Date**: YYYY-MM-DD

Last Verified: 2025-10-14 Next Update: 2025-10-17 (Mid-week check) Version: 4.1.5