clideck 1.31.17 → 1.31.19

package/skills/research-experiment/scripts/init-research-layout.mjs

@@ -1,184 +0,0 @@
-#!/usr/bin/env node
-
-import { mkdirSync, writeFileSync, existsSync } from 'node:fs';
-import { dirname, join, resolve } from 'node:path';
-
-function usage() {
-  console.error('Usage: node init-research-layout.mjs <experiment_dir> [researcher_count] [mode]');
-  console.error('  mode: code | knowledge');
-  process.exit(1);
-}
-
-const [, , experimentDirArg, researcherCountArg = '3', modeArg = 'knowledge'] = process.argv;
-
-if (!experimentDirArg) usage();
-
-const researcherCount = Number.parseInt(researcherCountArg, 10);
-const mode = String(modeArg).toLowerCase();
-
-if (!Number.isInteger(researcherCount) || researcherCount < 1 || researcherCount > 20) {
-  console.error('researcher_count must be an integer between 1 and 20');
-  process.exit(1);
-}
-
-if (!['code', 'knowledge'].includes(mode)) {
-  console.error('mode must be "code" or "knowledge"');
-  process.exit(1);
-}
-
-const experimentDir = resolve(experimentDirArg);
-const defaultThinkingStyles = [
-  'first-principles',
-  'evidence-first',
-  'systems-level',
-  'contrarian',
-  'creative/wildcard',
-];
-
-function ensureDir(dir) {
-  mkdirSync(dir, { recursive: true });
-}
-
-function writeIfMissing(path, content) {
-  ensureDir(dirname(path));
-  if (!existsSync(path)) writeFileSync(path, content, 'utf8');
-}
-
-function fileHeader(title) {
-  return `# ${title}\n\n`;
-}
-
-function thinkingStyleFor(index) {
-  return defaultThinkingStyles[(index - 1) % defaultThinkingStyles.length];
-}
-
-function promptTemplate(index, thinkingStyle) {
-  return `${fileHeader(`Researcher ${index} Prompt`)}## Goal
-
-## Decision Supported
-
-## Assigned Workspace
-
-Use an absolute path here when researchers will be launched manually in separate sessions.
-
-## Canonical Brief
-../EXPERIMENT.md
-
-## Log File
-./LOG.md
-
-## Findings File
-./FINDINGS.md
-
-## Ideas File
-./IDEAS.md
-
-## Allowed Tools And Sources
-
-## Forbidden Actions
-
-## Evidence Standard
-
-## Stop Conditions
-
-## Thinking Style
-${thinkingStyle}
-
-Use this thinking style to widen exploration, not to force a predetermined conclusion.
-
-## Researcher Operating Rules
-
-- Work independently.
-- Do not ask "should I continue?"
-- Keep working until you reach a credible conclusion or a real blocker.
-- Do not redefine the goal, evidence standard, constraints, or assigned workspace.
-- Do not read other researchers' interim work unless the manager explicitly allows collaboration.
-- Start with a question-generation round before choosing your first approach.
-- Explore multiple materially different approaches when the task is open-ended.
-- Explore at least one non-obvious or unconventional path.
-- Separate facts, evidence, and hypotheses clearly.
-- Record meaningful progress in \`LOG.md\`.
-- Record promising deferred ideas in \`IDEAS.md\`.
-- Write your final conclusion in \`FINDINGS.md\`.
-
-## Anti-Bias Rules
-
-- Do not assume the manager knows the answer.
-- Do not anchor on the most obvious solution too early.
-- Use the problem definition and constraints as your guide, not implied preferences.
-- Treat your assigned thinking style as a way to widen search, not to distort evidence.
-
-## Question Round
-
-Before taking your first action, generate a short list of high-value questions.
-
-Use the questions to widen the search space before committing to an approach.
-
-Also generate a new short question round after major failed or inconclusive attempts.
-
-Example questions:
-
-- what is actually expensive here?
-- what is actually causing the token bloat?
-- what is the current hard limit?
-- what happens if we remove this step entirely?
-- what happens if we compress, batch, defer, cache, or approximate it?
-- what quality signal might break if we optimize too aggressively?
-- what is the theoretical lower bound?
-- what assumptions are probably wrong?
-- what would a contrarian approach try first?
-- if the obvious path fails, what structurally different path is left?
-
-## Working Loop
-
-1. Re-read the goal, constraints, and evidence standard.
-2. Inspect the workspace and relevant context.
-3. Generate high-value questions about limits, assumptions, and overlooked paths.
-4. Form multiple candidate approaches from those questions.
-5. Choose one explainable experiment or line of inquiry.
-6. Execute it and gather evidence.
-7. Record what happened in \`LOG.md\`.
-8. Keep, revise, or reject the approach.
-9. Re-question after major failures or surprises.
-10. Repeat until success, exhaustion, or a true blocker.
-
-## Final Output Requirements
-
-Before stopping, complete \`FINDINGS.md\` with:
-
-- Executive summary
-- Recommendation
-- Confidence level
-- Approaches tried
-- Evidence collected
-- Failed or rejected paths
-- Remaining uncertainties
-- Suggested next steps
-`;
-}
-
-ensureDir(experimentDir);
-
-writeIfMissing(join(experimentDir, 'EXPERIMENT.md'), `${fileHeader('Experiment Brief')}## Objective\n\n## Decision Supported\n\n## Mode\n${mode}\n\n## Success Criteria\n\n## Evidence Standard\n\n## Constraints\n\n## Allowed Tools And Sources\n\n## Domain Context\n\n## Shared Resources\n\n## Stop Conditions\n\n## Researcher Independence Rules\n`);
-
-writeIfMissing(join(experimentDir, 'MANAGER.md'), `${fileHeader('Manager Notes')}## Intake Checklist\n\n## Open Questions\n\n## Round Control\n\n## Researcher Assignments\n`);
-
-writeIfMissing(join(experimentDir, 'SYNTHESIS.md'), `${fileHeader('Synthesis')}## Experiment Summary\n\n## Convergences\n\n## Divergences\n\n## Ranked Recommendations\n\n## Follow-Up Work\n`);
-
-for (let i = 1; i <= researcherCount; i += 1) {
-  const researcherDir = join(experimentDir, `researcher-${i}`);
-  const thinkingStyle = thinkingStyleFor(i);
-  ensureDir(researcherDir);
-
-  writeIfMissing(join(researcherDir, 'PROMPT.md'), promptTemplate(i, thinkingStyle));
-
-  writeIfMissing(join(researcherDir, 'LOG.md'), `${fileHeader(`Researcher ${i} Log`)}- Start here.\n`);
-  writeIfMissing(join(researcherDir, 'FINDINGS.md'), `${fileHeader(`Researcher ${i} Findings`)}## Executive Summary\n\n## Recommendation\n\n## Confidence Level\n\n## Approaches Tried\n\n## Evidence Collected\n\n## Failed Or Rejected Paths\n\n## Remaining Uncertainties\n\n## Suggested Next Steps\n`);
-  writeIfMissing(join(researcherDir, 'IDEAS.md'), `${fileHeader(`Researcher ${i} Ideas`)}- Add promising deferred ideas here.\n`);
-  writeIfMissing(join(researcherDir, 'WORKSPACE.md'), `${fileHeader(`Researcher ${i} Workspace`)}Mode: ${mode}\n\nUse this file to record the assigned workspace path and any workspace-specific rules.\n`);
-}
-
-console.log(`Created research layout at ${experimentDir}`);
-console.log(`Researchers: ${researcherCount}`);
-console.log(`Mode: ${mode}`);
-console.log(`Thinking styles: ${Array.from({ length: researcherCount }, (_, idx) => `r${idx + 1}=${thinkingStyleFor(idx + 1)}`).join(', ')}`);