Skip to content

v3.0 Structure Cleanup: PAI 4.0.3 Parity#81

Closed
Steffen025 wants to merge 8 commits intodevfrom
feature/v3.0-structure-cleanup
Closed

v3.0 Structure Cleanup: PAI 4.0.3 Parity#81
Steffen025 wants to merge 8 commits intodevfrom
feature/v3.0-structure-cleanup

Conversation

@Steffen025
Copy link
Owner

Summary

Final structure cleanup to achieve PAI 4.0.3 parity for v3.0 release.

Changes

  • Delete 26 flat duplicate skill directories (643 files)
  • Remove skills/PAI/ and skills/VoiceServer/ (wrong location)
  • Move 6 orphan skills into Utilities/
  • Rename voice-server/ to VoiceServer/ (CamelCase) + add missing files
  • Restore accidentally deleted files (THEPLUGINSYSTEM.md, PAI Tools)
  • Remove legacy content (pre-v3.0 artifacts, personal templates)
  • Fix THEHOOKSYSTEM to THEPLUGINSYSTEM references (ADR-001)
  • Regenerate skill-index.json (52 skills, 7 categories)

@coderabbitai
Copy link

coderabbitai bot commented Mar 20, 2026

Important

Review skipped

Too many files!

This PR contains 198 files, which is 48 over the limit of 150.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: ef989e3a-8790-416b-bff0-102db4dcd100

📥 Commits

Reviewing files that changed from the base of the PR and between 01ad76d and c82a334.

⛔ Files ignored due to path filters (2)
  • .opencode/skills/PAI/Tools/Transcribe-bun.lock is excluded by !**/*.lock, !**/*.lock
  • .opencode/skills/PAI/USER/TERMINAL/ul-circuit-embossed-v5.png is excluded by !**/*.png
📒 Files selected for processing (198)
  • .opencode/PAI/Algorithm/v3.7.0.md
  • .opencode/PAI/DOCUMENTATIONINDEX.md
  • .opencode/PAI/PIPELINES.md
  • .opencode/PAI/SKILL.md
  • .opencode/PAI/THEPLUGINSYSTEM.md
  • .opencode/PAI/Tools/GenerateSkillIndex.ts
  • .opencode/PAI/Tools/SkillSearch.ts
  • .opencode/PAI/Tools/ValidateSkillStructure.ts
  • .opencode/PAI/Tools/algorithm.ts
  • .opencode/PAI/doc-dependencies.json
  • .opencode/PAISECURITYSYSTEM/HOOKS.md
  • .opencode/VoiceServer/README.md
  • .opencode/VoiceServer/install.sh
  • .opencode/VoiceServer/logs/README.md
  • .opencode/VoiceServer/menubar/install-menubar.sh
  • .opencode/VoiceServer/menubar/pai-voice.5s.sh
  • .opencode/VoiceServer/pronunciations.json
  • .opencode/VoiceServer/restart.sh
  • .opencode/VoiceServer/server.ts
  • .opencode/VoiceServer/start.sh
  • .opencode/VoiceServer/status.sh
  • .opencode/VoiceServer/stop.sh
  • .opencode/VoiceServer/uninstall.sh
  • .opencode/VoiceServer/voices.json
  • .opencode/agents/Algorithm.md
  • .opencode/skills/PAI/CONSTITUTION.md
  • .opencode/skills/PAI/SKILL.md
  • .opencode/skills/PAI/SYSTEM/.gitkeep
  • .opencode/skills/PAI/SYSTEM/AISTEERINGRULES.md
  • .opencode/skills/PAI/SYSTEM/BACKUPS.md
  • .opencode/skills/PAI/SYSTEM/BROWSERAUTOMATION.md
  • .opencode/skills/PAI/SYSTEM/CLIFIRSTARCHITECTURE.md
  • .opencode/skills/PAI/SYSTEM/DOCUMENTATIONINDEX.md
  • .opencode/skills/PAI/SYSTEM/MEMORYSYSTEM.md
  • .opencode/skills/PAI/SYSTEM/PAIAGENTSYSTEM.md
  • .opencode/skills/PAI/SYSTEM/PAISECURITYSYSTEM/ARCHITECTURE.md
  • .opencode/skills/PAI/SYSTEM/PAISECURITYSYSTEM/COMMANDINJECTION.md
  • .opencode/skills/PAI/SYSTEM/PAISECURITYSYSTEM/PROMPTINJECTION.md
  • .opencode/skills/PAI/SYSTEM/PAISECURITYSYSTEM/README.md
  • .opencode/skills/PAI/SYSTEM/PAISECURITYSYSTEM/patterns.example.yaml
  • .opencode/skills/PAI/SYSTEM/PAISYSTEMARCHITECTURE.md
  • .opencode/skills/PAI/SYSTEM/PIPELINES.md
  • .opencode/skills/PAI/SYSTEM/RESPONSEFORMAT.md
  • .opencode/skills/PAI/SYSTEM/SCRAPINGREFERENCE.md
  • .opencode/skills/PAI/SYSTEM/SYSTEM_USER_EXTENDABILITY.md
  • .opencode/skills/PAI/SYSTEM/SkillSystem.md
  • .opencode/skills/PAI/SYSTEM/TERMINALTABS.md
  • .opencode/skills/PAI/SYSTEM/THEDELEGATIONSYSTEM.md
  • .opencode/skills/PAI/SYSTEM/THEFABRICSYSTEM.md
  • .opencode/skills/PAI/SYSTEM/THENOTIFICATIONSYSTEM.md
  • .opencode/skills/PAI/SYSTEM/TOOLS.md
  • .opencode/skills/PAI/SYSTEM/UPDATES/2026-01-08_multi-channel-notification-system.md
  • .opencode/skills/PAI/Tools/.gitkeep
  • .opencode/skills/PAI/Tools/ActivityParser.ts
  • .opencode/skills/PAI/Tools/AddBg.ts
  • .opencode/skills/PAI/Tools/Banner.ts
  • .opencode/skills/PAI/Tools/BannerMatrix.ts
  • .opencode/skills/PAI/Tools/BannerNeofetch.ts
  • .opencode/skills/PAI/Tools/BannerPrototypes.ts
  • .opencode/skills/PAI/Tools/BannerRetro.ts
  • .opencode/skills/PAI/Tools/BannerTokyo.ts
  • .opencode/skills/PAI/Tools/ExtractTranscript.ts
  • .opencode/skills/PAI/Tools/FeatureRegistry.ts
  • .opencode/skills/PAI/Tools/GetTranscript.ts
  • .opencode/skills/PAI/Tools/Inference.ts
  • .opencode/skills/PAI/Tools/LearningPatternSynthesis.ts
  • .opencode/skills/PAI/Tools/LoadSkillConfig.ts
  • .opencode/skills/PAI/Tools/NeofetchBanner.ts
  • .opencode/skills/PAI/Tools/PAILogo.ts
  • .opencode/skills/PAI/Tools/RemoveBg.ts
  • .opencode/skills/PAI/Tools/SecretScan.ts
  • .opencode/skills/PAI/Tools/SessionHarvester.ts
  • .opencode/skills/PAI/Tools/SessionProgress.ts
  • .opencode/skills/PAI/Tools/SplitAndTranscribe.ts
  • .opencode/skills/PAI/Tools/Transcribe-package.json
  • .opencode/skills/PAI/Tools/TranscriptParser.ts
  • .opencode/skills/PAI/Tools/WisdomFrameUpdater.ts
  • .opencode/skills/PAI/Tools/YouTubeApi.ts
  • .opencode/skills/PAI/Tools/extract-transcript.py
  • .opencode/skills/PAI/Tools/pai.ts
  • .opencode/skills/PAI/USER/.gitkeep
  • .opencode/skills/PAI/USER/ABOUTME.md
  • .opencode/skills/PAI/USER/AISTEERINGRULES.md
  • .opencode/skills/PAI/USER/ALGOPREFS.md
  • .opencode/skills/PAI/USER/ARCHITECTURE.md
  • .opencode/skills/PAI/USER/ASSETMANAGEMENT.md
  • .opencode/skills/PAI/USER/BANNER/README.md
  • .opencode/skills/PAI/USER/BASICINFO.md
  • .opencode/skills/PAI/USER/BUSINESS/README.md
  • .opencode/skills/PAI/USER/CONTACTS.md
  • .opencode/skills/PAI/USER/CORECONTENT.md
  • .opencode/skills/PAI/USER/DAIDENTITY.md
  • .opencode/skills/PAI/USER/DEFINITIONS.md
  • .opencode/skills/PAI/USER/FINANCES/README.md
  • .opencode/skills/PAI/USER/HEALTH/README.md
  • .opencode/skills/PAI/USER/PAISECURITYSYSTEM/README.md
  • .opencode/skills/PAI/USER/PRODUCTIVITY.md
  • .opencode/skills/PAI/USER/README.md
  • .opencode/skills/PAI/USER/REMINDERS.md
  • .opencode/skills/PAI/USER/RESPONSEFORMAT.md
  • .opencode/skills/PAI/USER/RESUME.md
  • .opencode/skills/PAI/USER/SKILLCUSTOMIZATIONS/Art/CharacterSpecs.md
  • .opencode/skills/PAI/USER/SKILLCUSTOMIZATIONS/Art/EXTEND.yaml
  • .opencode/skills/PAI/USER/SKILLCUSTOMIZATIONS/Art/PREFERENCES.md
  • .opencode/skills/PAI/USER/SKILLCUSTOMIZATIONS/Art/SceneConstruction.md
  • .opencode/skills/PAI/USER/SKILLCUSTOMIZATIONS/README.md
  • .opencode/skills/PAI/USER/STATUSLINE/README.md
  • .opencode/skills/PAI/USER/TECHSTACKPREFERENCES.md
  • .opencode/skills/PAI/USER/TELOS/.gitkeep
  • .opencode/skills/PAI/USER/TELOS/BELIEFS.md
  • .opencode/skills/PAI/USER/TELOS/BOOKS.md
  • .opencode/skills/PAI/USER/TELOS/CHALLENGES.md
  • .opencode/skills/PAI/USER/TELOS/FRAMES.md
  • .opencode/skills/PAI/USER/TELOS/GOALS.md
  • .opencode/skills/PAI/USER/TELOS/IDEAS.md
  • .opencode/skills/PAI/USER/TELOS/LEARNED.md
  • .opencode/skills/PAI/USER/TELOS/MISSION.md
  • .opencode/skills/PAI/USER/TELOS/MODELS.md
  • .opencode/skills/PAI/USER/TELOS/MOVIES.md
  • .opencode/skills/PAI/USER/TELOS/NARRATIVES.md
  • .opencode/skills/PAI/USER/TELOS/PREDICTIONS.md
  • .opencode/skills/PAI/USER/TELOS/PROBLEMS.md
  • .opencode/skills/PAI/USER/TELOS/PROJECTS.md
  • .opencode/skills/PAI/USER/TELOS/README.md
  • .opencode/skills/PAI/USER/TELOS/STATUS.md
  • .opencode/skills/PAI/USER/TELOS/STRATEGIES.md
  • .opencode/skills/PAI/USER/TELOS/TELOS.md
  • .opencode/skills/PAI/USER/TELOS/TRAUMAS.md
  • .opencode/skills/PAI/USER/TELOS/WISDOM.md
  • .opencode/skills/PAI/USER/TELOS/WRONG.md
  • .opencode/skills/PAI/USER/TERMINAL/README.md
  • .opencode/skills/PAI/USER/TERMINAL/ZSHRC
  • .opencode/skills/PAI/USER/TERMINAL/kitty.conf
  • .opencode/skills/PAI/USER/TERMINAL/shortcuts.md
  • .opencode/skills/PAI/USER/WORK/README.md
  • .opencode/skills/PAI/WORK/.gitkeep
  • .opencode/skills/PAI/Workflows/BackgroundDelegation.md
  • .opencode/skills/PAI/Workflows/Delegation.md
  • .opencode/skills/PAI/Workflows/GitPush.md
  • .opencode/skills/PAI/Workflows/HomeBridgeManagement.md
  • .opencode/skills/PAI/Workflows/ImageProcessing.md
  • .opencode/skills/PAI/Workflows/Onboarding.md
  • .opencode/skills/PAI/Workflows/SessionCommit.md
  • .opencode/skills/PAI/Workflows/SessionContinuity.md
  • .opencode/skills/PAI/Workflows/Transcription.md
  • .opencode/skills/PAI/Workflows/TreeOfThought.md
  • .opencode/skills/PAI/Workflows/UpdateDocumentation.md
  • .opencode/skills/Utilities/AudioEditor/SKILL.md
  • .opencode/skills/Utilities/AudioEditor/Tools/Analyze.help.md
  • .opencode/skills/Utilities/AudioEditor/Tools/Analyze.ts
  • .opencode/skills/Utilities/AudioEditor/Tools/Edit.help.md
  • .opencode/skills/Utilities/AudioEditor/Tools/Edit.ts
  • .opencode/skills/Utilities/AudioEditor/Tools/Pipeline.help.md
  • .opencode/skills/Utilities/AudioEditor/Tools/Pipeline.ts
  • .opencode/skills/Utilities/AudioEditor/Tools/Polish.help.md
  • .opencode/skills/Utilities/AudioEditor/Tools/Polish.ts
  • .opencode/skills/Utilities/AudioEditor/Tools/Transcribe.help.md
  • .opencode/skills/Utilities/AudioEditor/Tools/Transcribe.ts
  • .opencode/skills/Utilities/AudioEditor/Workflows/Clean.md
  • .opencode/skills/Utilities/CodeReview/SKILL.md
  • .opencode/skills/Utilities/OpenCodeSystem/SKILL.md
  • .opencode/skills/Utilities/Sales/SKILL.md
  • .opencode/skills/Utilities/Sales/Workflows/CreateNarrative.md
  • .opencode/skills/Utilities/Sales/Workflows/CreateSalesPackage.md
  • .opencode/skills/Utilities/Sales/Workflows/CreateVisual.md
  • .opencode/skills/Utilities/System/SKILL.md
  • .opencode/skills/Utilities/System/Tools/CreateUpdate.ts
  • .opencode/skills/Utilities/System/Tools/SecretScan.ts
  • .opencode/skills/Utilities/System/Tools/UpdateIndex.ts
  • .opencode/skills/Utilities/System/Tools/UpdateSearch.ts
  • .opencode/skills/Utilities/System/Workflows/CrossRepoValidation.md
  • .opencode/skills/Utilities/System/Workflows/DocumentRecent.md
  • .opencode/skills/Utilities/System/Workflows/DocumentSession.md
  • .opencode/skills/Utilities/System/Workflows/GitPush.md
  • .opencode/skills/Utilities/System/Workflows/IntegrityCheck.md
  • .opencode/skills/Utilities/System/Workflows/PrivacyCheck.md
  • .opencode/skills/Utilities/System/Workflows/SecretScanning.md
  • .opencode/skills/Utilities/System/Workflows/WorkContextRecall.md
  • .opencode/skills/Utilities/WriteStory/AestheticProfiles.md
  • .opencode/skills/Utilities/WriteStory/AntiCliche.md
  • .opencode/skills/Utilities/WriteStory/Critics.md
  • .opencode/skills/Utilities/WriteStory/RhetoricalFigures.md
  • .opencode/skills/Utilities/WriteStory/SKILL.md
  • .opencode/skills/Utilities/WriteStory/StorrFramework.md
  • .opencode/skills/Utilities/WriteStory/StoryLayers.md
  • .opencode/skills/Utilities/WriteStory/StoryStructures.md
  • .opencode/skills/Utilities/WriteStory/Workflows/BuildBible.md
  • .opencode/skills/Utilities/WriteStory/Workflows/Explore.md
  • .opencode/skills/Utilities/WriteStory/Workflows/Interview.md
  • .opencode/skills/Utilities/WriteStory/Workflows/Revise.md
  • .opencode/skills/Utilities/WriteStory/Workflows/WriteChapter.md
  • .opencode/skills/VoiceServer/SKILL.md
  • .opencode/skills/VoiceServer/Tools/VoiceServerManager.ts
  • .opencode/skills/VoiceServer/Workflows/Status.md
  • .opencode/skills/skill-index.json
  • .prd/PRD-20260309-coderabbit-pr47-fixes.md
  • .prd/PRD-20260309-installer-refactor.md
  • docs/architecture/INSTALLER-REFACTOR-PLAN.md

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • ✅ Review completed - (🔄 Check again to review again)
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feature/v3.0-structure-cleanup
📝 Coding Plan
  • Generate coding plan for human review comments

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

PAI belongs at .opencode/PAI/ (root level), not under skills/.
VoiceServer belongs at .opencode/VoiceServer/ (root level), not under skills/.
Both are core infrastructure, not domain skills.

Aligns with PAI 4.0.3 upstream structure.
Moved 6 flat-level skills into Utilities/ for PAI 4.0.3 parity:
- AudioEditor → Utilities/AudioEditor (was missing from Utilities)
- CodeReview → Utilities/CodeReview (OpenCode-specific)
- OpenCodeSystem → Utilities/OpenCodeSystem (OpenCode-specific)
- Sales → Utilities/Sales (OpenCode-specific)
- System → Utilities/System (OpenCode-specific)
- WriteStory → Utilities/WriteStory (OpenCode-specific)

OpenCode-specific skills preserved in Utilities/ category.
Renamed: voice-server/ → VoiceServer/ (CamelCase, matches PAI 4.0.3)

Added missing files from PAI 4.0.3:
- install.sh, start.sh, stop.sh, restart.sh, status.sh, uninstall.sh
- voices.json, pronunciations.json
- menubar/ directory

All .claude/ references replaced with .opencode/ in copied files.
Added 3 files missing from PAI/ root:
- doc-dependencies.json (documentation dependency graph)
- PIPELINES.md (pipeline system documentation)
- THEHOOKSYSTEM.md (hooks/plugin system documentation)

All .claude/ references replaced with .opencode/.
OpenCode uses plugins, not hooks. The plugin system documentation
lives at docs/PLUGIN-SYSTEM.md per ADR-001 (Hooks → Plugins).
…eletion

Restored from git history (accidentally deleted with skills/PAI/):
- PAI/THEPLUGINSYSTEM.md (OpenCode replacement for THEHOOKSYSTEM.md)
- PAI/Tools/GenerateSkillIndex.ts + ValidateSkillStructure.ts + SkillSearch.ts
- PAI/PIPELINES.md, PAI/doc-dependencies.json
- PAISECURITYSYSTEM/HOOKS.md

Removed legacy files NOT in 4.0.3 upstream:
- PAI/BACKUPS.md, BROWSERAUTOMATION.md, CONSTITUTION.md, RESPONSEFORMAT.md,
  SCRAPINGREFERENCE.md, TERMINALTABS.md (all pre-v3.0 artifacts)
- PAI/UPDATES/ directory (not in 4.0.3)
- PAI/Workflows/ (11 legacy workflows not in 4.0.3 root)
- PAI/USER/ reset to 4.0.3 template (README.md placeholders only,
  removed 47 personal template files that don't belong in public repo)

Fixed references: THEHOOKSYSTEM → THEPLUGINSYSTEM in SKILL.md and DOCUMENTATIONINDEX.md

Regenerated skill-index.json (52 skills, 7 categories)

PAI/ root now matches 4.0.3 exactly, with only 2 justified deviations:
- THEPLUGINSYSTEM.md (replaces THEHOOKSYSTEM.md per ADR-001)
- MINIMAL_BOOTSTRAP.md (OpenCode lazy loading, created in v3.0 WP-C)
VoiceServer sendNotification() now uses title (agent name) instead of
voiceId for voice resolution. This enables dynamic provider switching
via TTS_PROVIDER env var (google/elevenlabs/macos).

Changed: voice_id:'fTtv3eikoepIosk8dTZ5' → voice_id:'default' + title:'AgentName'

Files affected:
- VoiceServer/server.ts (line 425: voiceId → safeTitle)
- PAI/SKILL.md (7 phase curls)
- PAI/Algorithm/v3.7.0.md (2 voice curls)
- agents/Algorithm.md (frontmatter + 3 references)
- PAI/Tools/algorithm.ts (VOICE_ID constant)

Zero hardcoded ElevenLabs IDs remain in the codebase.
@Steffen025
Copy link
Owner Author

Superseded — Split for CodeRabbit Review

This PR (~200 files) exceeded CodeRabbit's practical review limit of ~100 files. It has been split into two stacked PRs:

PR Branch Files Scope
#82 feature/v3.0-part-a 132 Remove misplaced skills/PAI/ and skills/VoiceServer/ directories
#83 feature/v3.0-part-b 74 Add correct structure: Utilities/, VoiceServer rename, PAI root docs, voice ID fix

All commits from this PR are preserved verbatim in the split branches. Closing this PR — please review #82 first, then #83.

@Steffen025 Steffen025 closed this Mar 20, 2026
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