Skip to content

fix: sync socratic-code-theory-recovery skill into plugin bundle (follow-up to #478)#479

Merged
rdmueller merged 1 commit into
LLM-Coding:mainfrom
raifdmueller:fix/sync-socratic-skill-plugin
May 14, 2026
Merged

fix: sync socratic-code-theory-recovery skill into plugin bundle (follow-up to #478)#479
rdmueller merged 1 commit into
LLM-Coding:mainfrom
raifdmueller:fix/sync-socratic-skill-plugin

Conversation

@raifdmueller
Copy link
Copy Markdown
Contributor

@raifdmueller raifdmueller commented May 14, 2026

Follow-up to #478. The skill is on main under `skill/socratic-code-theory-recovery/` but never made it into `plugins/semantic-anchors/skills/` because `core.hooksPath` was not set in my local clone — so the pre-commit hook that ordinarily mirrors the canonical `skill/` directory into the plugin bundle did not run when I committed.

Symptom: `/plugin install semantic-anchors@semantic-anchors` in Claude Code installs Translator and Onboarding but not the new Recovery skill, because Claude Code reads from the plugin bundle directory, not from `skill/`.

This PR runs the sync (`scripts/sync-claude-plugin.sh`) and adds the resulting files. It also pulls in the marketplace-install documentation update that was meant to land with the original PR but got pushed too late: `docs/socratic-recovery-skill.adoc` (EN+DE) now leads with the marketplace install flow as the recommended path, with the manual `CLAUDE.md` reference kept as alternative.

After merge: `/plugin marketplace update semantic-anchors` + `/plugin install semantic-anchors@semantic-anchors` + `/reload-plugins` will pick up the new skill.

🤖 Generated with Claude Code

Summary by CodeRabbit

Versionshinweise

  • Neue Funktionen

    • Neue Dokumentationswiederherstellungs-Skill für systematische Frage-Baum-Analyse und Synthese von Spezifikationen hinzugefügt.
  • Dokumentation

    • Aktualisierte Claude Code Installationsanweisungen über Plugin-Marketplace.
    • Erweiterte Semantic Anchors-Katalog mit neuen Konzepten und Referenzmaterialien.
    • Umfassende Referenzguides für Architektur, Qualitätsmodelle, Use Cases und Design-Entscheidungen hinzugefügt.

Review Change Stack

…oding#473)

This repository is already published as a Claude Code plugin marketplace
(see .claude-plugin/marketplace.json + plugins/semantic-anchors/plugin.json),
and the pre-commit hook syncs skill/ into plugins/semantic-anchors/skills/.
End users can therefore install all bundled skills with two slash-commands
instead of editing CLAUDE.md by hand.

- Update docs/socratic-recovery-skill.adoc (EN+DE): Claude Code section
  now leads with
    /plugin marketplace add LLM-Coding/Semantic-Anchors
    /plugin install semantic-anchors@semantic-anchors
  as the recommended path; manual CLAUDE.md reference kept as alternative
  for corporate installs, pinned versions, or custom skill locations.
- Sync the new skill into plugins/semantic-anchors/skills/ so the
  marketplace install actually delivers it (the pre-commit hook
  ordinarily handles this, but core.hooksPath was not set locally).
- Pick up the translator catalog refresh that the same hook would have
  produced after the three community anchors merged.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 14, 2026

Caution

Review failed

Pull request was closed or merged during review

Walkthrough

Dieses Update erweitert die Semantic Anchors Dokumentation um eine umfassende Skill für Socratic Code-Theory Recovery. Es aktualisiert Installationsanweisungen auf Marketplace-Basis, erweitert den Katalog um 24+ Semantic Anchors und fügt eine vollständige zwei-Phase-Workflow-Dokumentation mit Prompts, Decomposition-Guides und Output-Spezifikationen hinzu.

Changes

Socratic Code-Theory Recovery und Katalog-Integration

Layer / File(s) Summary
Installation und Benutzerrichtlinien
docs/socratic-recovery-skill.adoc, docs/socratic-recovery-skill.de.adoc
Installationsanleitung modernisiert: Marketplace-basierte Plugin-Installation als empfohlener Hauptweg mit sofortiger Skill-Verfügbarkeit; manuelle CLAUDE.md-Referenzierung explizit als Alternative neu positioniert; Anleitung zur Custom-Skill-Directory-Platzierung entfernt.
Semantic Anchors Katalog-Erweiterung
plugins/semantic-anchors/skills/semantic-anchor-translator/references/catalog.md
24+ neue Katalog-Einträge über mehrere Kategorien hinzugefügt (Red/Green TDD, Lehman Classification, SLAP, Occam's Razor, WWCND, XY Problem, Double Diamond, Cockburn Use Cases, 4MAT, Thin Vertical Slice, Spike Solution, Kano Model, Kotter's 8-Step Change, PERT, MVP, Hoshin Kanri, Decisional Balance Sheet); OWASP Top 10 neu organisiert.
Skill-Definition und Workflow-Vertrag
plugins/semantic-anchors/skills/socratic-code-theory-recovery/SKILL.md
Umfassende Skill-Metadaten und zwei-Phase-Workflow-Definition: Phase 1 baut Fragenbäume aus Code, Phase 2 synthetisiert PRD/Specs/Architecture/ADRs. Definiert Kontakt für [ANSWERED] (Code-evidenziert) und [OPEN] (Team-beantwortet) Blätter; Claim-Provenance-Regeln und Spec-Drift-Reconciliation.
Phase 1 Prompt: Fragenbaum-Konstruktion
plugins/semantic-anchors/skills/socratic-code-theory-recovery/prompts/phase-1-question-tree.md
Phase-1-Prompt: Hierarchischer Fragenbaum-Aufbau mit fünf initialen Fragen (Q1–Q5), Decomposition-Guides pro Frage-Zweig, Q-ID-Schema, strikte [ANSWERED]/[OPEN] Klassifizierung mit Evidence-Format (file:line, file::function), Ausgabe-Constraints (QUESTION_TREE.adoc, OPEN_QUESTIONS.adoc) und Post-Validierungsschritte.
Phase 2 Prompt: Dokumentsynthese
plugins/semantic-anchors/skills/socratic-code-theory-recovery/prompts/phase-2-synthesize.md
Phase-2-Prompt: Synthesiert vier Dokumentartefakte (PRD, Use-Case-Specs, arc42, Nygard ADRs mit Pugh-Matrix). Erzwingt Q-ID-Rückverfolgbarkeit in jedem Absatz, Team-Antwort-Markierung, explizites Deferred-Gap-Handling ohne Erfindung, und Anleitung zur Spec-Drift-Detection durch Phase-1-Rerun.
Decomposition-Richtlinien für Fragenarten
plugins/semantic-anchors/skills/socratic-code-theory-recovery/references/arc42.md, .../cockburn-use-cases.md, .../iso-25010.md, .../nygard-adrs.md
Spezialisierte Referenzdokumentation: arc42 12-Abschnitte als Q3 Sub-Fragen; Cockburn Fully Dressed Format für Q2 Use Cases mit Primary Actor, Stakeholders, Szenarien; ISO/IEC 25010 Qualitätsmerkmale für Q4 mit Derivable-vs-Open Tabelle; Nygard ADR Felder für Q3.9 Design Rationale mit Pugh-Matrix-Anleitung.
Worked Examples und Output-Schema
plugins/semantic-anchors/skills/socratic-code-theory-recovery/references/examples.md, .../output-schema.md
Worked Examples mit Q1–Q5 Musterfragablätter, Evidence-Zitierkonventionen und [ANSWERED]/[OPEN] Formatierungsvorlagen; Output-Schema präzisiert QUESTION_TREE.adoc (hierarchisch, Q-ID-markiert) und OPEN_QUESTIONS.adoc (flach, Rollen-gruppiert) mit strikten Formatierungsvorgaben und Phase-2-Rückverfolgbarkeitsforderungen.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

  • LLM-Coding/Semantic-Anchors#454: Registriert die Socratic-Code-Theory-Recovery Skill als Vertrag in contracts.json und dokumentiert das entsprechende Anker-Metadaten-Setup.
  • LLM-Coding/Semantic-Anchors#455: Dokumentiert die Socratic Code-Theory Recovery Skill als Bestandteil des Brownfield-Workflows in docs/brownfield-workflow.adoc.
  • LLM-Coding/Semantic-Anchors#478: Aktualisiert die Installationsanweisungen für Socratic-Code-Theory-Recovery Skill mit Marketplace-basierter Installation und entfernt manuelle skill/.../SKILL.md-Platzierungsanleitung.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed Der Titel beschreibt präzise die Hauptänderung: Synchronisierung der neuen Socratic-Code-Theory-Recovery-Skill in das Plugin-Bundle, als Folgemaßnahme zu Issue #478.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

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.

@rdmueller rdmueller merged commit d9190c2 into LLM-Coding:main May 14, 2026
6 of 7 checks passed
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.

2 participants