@longtable/provider-claude 0.1.41 → 0.1.43

package/dist/skills.js

@@ -65,8 +65,12 @@ function baseSkillSpecs(surface = "compact") {
                 "- The compact visible shortcut set is methods, measure, theory, reviewer, and voice. Other roles remain available through this router when the request calls for them.",
                 "- Prefer natural language over asking the researcher to run shell role commands.",
                 "- For `$longtable-interview`, use natural-language turns for the interview and reserve structured options for final First Research Shape confirmation.",
+                "- Do not let unrelated pending Researcher Checkpoints interrupt the interview. Mention them only as separate unresolved checkpoints, and treat them as blocking only when the researcher is confirming, saving, or recording a research decision.",
                 "- If a Researcher Checkpoint is needed, ask a short structured question with meaningful options and wait for the researcher.",
                 "- If changing LongTable product language, README positioning, or checkpoint policy, ask a Meta-Decision Checkpoint first.",
+                "- Stop before acting when the request would change the research question/scope, theory frame, measurement/coding standard, method design, or analysis strategy.",
+                "- For low-risk reversible work, proceed with explicit assumptions instead of interrupting.",
+                "- For LongTable product, hook, setup, release, or documentation work, do not create research-state QuestionRecords.",
                 "- If a checkpoint allows `other`, make `other` visible instead of hiding it in state.",
                 "- Treat Claude's structured question surface as transport; LongTable state records are the source of truth.",
                 "- When an MCP `elicit_question` tool is available in the client, use it first so the checkpoint can be shown through the native elicitation surface and recorded in LongTable state.",
@@ -76,6 +80,16 @@ function baseSkillSpecs(surface = "compact") {
                 "- Disclose consulted roles with `LongTable consulted: ...` when a role is foregrounded.",
                 "- Label unsupported external claims as inference or estimate.",
                 "",
+                "## Panel And Question Ordering",
+                "",
+                "- If the user asks for a panel, team, disagreement, or multiple perspectives, expose a structured deliberation record instead of a one-line summary.",
+                "- The structured deliberation record must include: roles consulted, each role's main claim or objection, the disagreement map, the decision options, the recommended option when defensible, and the exact researcher-facing question.",
+                "- If the panel converges, explain what changed the disagreement; if it does not converge, preserve the unresolved conflict instead of collapsing it into one confident synthesis.",
+                "- Ask and stop when missing context would decide a high-risk research commitment.",
+                "- Continue with stated assumptions when the missing context is low-risk, reversible, or purely presentational.",
+                "- Rank questions by importance and risk; prefer one grouped high-leverage question over a long questionnaire.",
+                "- When human knowledge, AI inference, and project state conflict, make the conflict visible and ask for human clarity before treating the direction as settled.",
+                "",
                 "## Optional CLI Bridge",
                 "",
                 "If the `longtable` command is available and canonical prompt rendering would help, use `longtable ask --print --prompt \"...\"` or `longtable panel --print --prompt \"...\"` as an adapter aid. Do not make shell commands the user's primary interface."
@@ -98,9 +112,10 @@ function baseSkillSpecs(surface = "compact") {
                 "4. Ask one natural-language question at a time.",
                 "5. Evaluate answer quality before classifying it.",
                 "6. Record turns with MCP `append_interview_turn` when available.",
-                "7. Continue until there is enough context for a provisional `first_research_handle`.",
+                "7. Continue until there is content-based readiness for a provisional `first_research_handle`; never stop merely because a fixed number of turns has passed.",
                 "8. Store the First Research Shape with MCP `summarize_interview`.",
                 "9. Use MCP `confirm_first_research_shape` for the final structured confirmation.",
+                "10. If the researcher explicitly cancels the interview, use MCP `cancel_interview` when available. Do not cancel durable state for a casual topic change unless the researcher says to cancel the interview.",
                 "",
                 "## Opening",
                 "",
@@ -116,8 +131,29 @@ function baseSkillSpecs(surface = "compact") {
                 "- Use a quiet research-note tone.",
                 "- Reflect with `LongTable hears:` before the next question.",
                 "- Ask one question only; wait for the researcher.",
+                "- Keep the follow-up focused on one main uncertainty. A sentence may name nearby tensions for context, but avoid bundling several answerable questions into a mini-questionnaire.",
                 "- If an answer is thin, ask for one more sentence instead of classifying it.",
                 "- Treat one-word or one-letter answers as `quality: thin`.",
+                "- Keep hook-added context out of normal replies unless it changes the next research action.",
+                "",
+                "## Turn Recording",
+                "",
+                "`append_interview_turn` records the durable interview trace in `.longtable/state.json`: the question asked, the researcher answer, a short reflection, answer quality, whether a follow-up is needed, and any content-based readiness rationale. If MCP tools are unavailable, continue the interview but say that this durable turn was not written.",
+                "",
+                "Do not set `readyToSummarize: true` because of turn count. Set it only when the answer history supports the closure-readiness criteria below.",
+                "",
+                "## Closure Readiness",
+                "",
+                "End the interview only when the conversation has enough material to support later research work:",
+                "",
+                "- research object: what kind of artifact or study decision LongTable is shaping",
+                "- focal uncertainty: what remains hard to name, justify, or inspect",
+                "- construct or boundary: what should count and what should not count",
+                "- evidence/material: where the first inspection will happen",
+                "- protected decision: what LongTable must not settle silently",
+                "- next action: the next concrete research move",
+                "",
+                "Some projects may need two turns; others may need ten or more. If these elements are still vague, ask another natural-language question instead of summarizing.",
                 "",
                 "## First Research Shape",
                 "",
@@ -131,7 +167,9 @@ function baseSkillSpecs(surface = "compact") {
                 "- nextAction",
                 "- confidence",
                 "",
-                "Use structured options only for the final confirmation or true checkpoint boundaries. If MCP is unavailable, continue in natural language but do not claim that state was written."
+                "Use structured options only for the final confirmation or true checkpoint boundaries. Show the options in the researcher's current language when possible, usually: save/confirm, ask one more question, revise, or keep open. If MCP is unavailable, continue in natural language but do not claim that state was written.",
+                "",
+                "If a confirmed First Research Shape already exists, do not reopen the interview automatically. Summarize the existing shape and ask whether to continue from it, revise it, or explicitly start a new interview."
             ]
         },
         {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/provider-claude",
-  "version": "0.1.41",
+  "version": "0.1.43",
   "private": false,
   "description": "Claude adapter surface for LongTable",
   "type": "module",
@@ -21,9 +21,9 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@longtable/checkpoints": "0.1.41",
-    "@longtable/core": "0.1.41",
-    "@longtable/setup": "0.1.41"
+    "@longtable/checkpoints": "0.1.43",
+    "@longtable/core": "0.1.43",
+    "@longtable/setup": "0.1.43"
   },
   "devDependencies": {
     "typescript": "^5.6.0"