codex-arsenal 0.4.0 → 0.5.0

package/CODEX.md

@@ -6,23 +6,6 @@
 
 ---
 
-## Session Bootstrap
-
-When this repository is installed into a project, read `prompts/session-bootstrap.md` immediately after `CODEX.md` if it exists.
-
-If `configs/codex/session-config.json` exists, use it as the project-local source of truth for:
-
-- the session initializer path;
-- the code-style note path;
-- the meaningful-work criteria;
-- the Obsidian vault and inbox paths.
-
-If the configured code-style note exists, merge it into your working style before editing files.
-
-If the task satisfies the meaningful-work criteria, draft an Obsidian article at the end of the session.
-
----
-
 ## 1. Think Before Coding
 
 **Don't assume. Don't hide confusion. Surface tradeoffs.**
@@ -86,9 +69,9 @@ Transform tasks into verifiable goals:
 For multi-step tasks, state a brief plan:
 
 ```
-1. [Step] → verify: [check]
-2. [Step] → verify: [check]
-3. [Step] → verify: [check]
+1. [Step] -> verify: [check]
+2. [Step] -> verify: [check]
+3. [Step] -> verify: [check]
 ```
 
 Strong success criteria let you loop independently.  
@@ -108,31 +91,7 @@ Weak criteria ("make it work") require constant clarification.
 
 ---
 
-## 6. Token Budgeting
-
-**Spend context only where it changes the decision.**
-
-- Start with filenames, symbols, and short snippets before reading full files.
-- Prefer `rg` and targeted search over broad recursive reads.
-- Summarize long outputs immediately: key facts, file paths, line numbers, open questions.
-- Do not paste large logs back to the user. Quote only the failing line or smallest useful excerpt.
-- Reuse already-loaded context instead of re-reading the same files.
-- When handing off, compress to: goal, changed files, commands run, verification status, next risk.
-
----
-
-## 7. Context Awareness
-
-**Codex has a limited context window — use it wisely.**
-
-- Don't re-read files you've already loaded. Reference prior output instead.
-- When summarizing large codebases, compress systematically: directory tree → key files → function signatures.
-- If context is filling up, state it: *"I'm approaching context limits. Summarizing and continuing."*
-- Prefer targeted grep/search over reading entire files when looking for a specific symbol.
-
----
-
-## 8. Tool Use Discipline
+## 6. Tool Use Discipline
 
 **Every tool call has a cost. Make them count.**
 
@@ -143,7 +102,7 @@ Weak criteria ("make it work") require constant clarification.
 
 ---
 
-## ✅ These guidelines are working if:
+## These guidelines are working if:
 
 - Diffs contain fewer unnecessary changes
 - Fewer rewrites due to overcomplication

package/README.md

@@ -24,6 +24,14 @@ Install specific items:
 npx codex-arsenal get codex-md skill-publishing-npm-packages
 ```
 
+Install optional planning, token-efficiency, or Obsidian support:
+
+```bash
+npx codex-arsenal get option-plan-counterargument
+npx codex-arsenal get option-token-efficient-execution
+npx codex-arsenal get option-obsidian-session-loop
+```
+
 Install into another directory:
 
 ```bash
@@ -71,6 +79,16 @@ The package is published on npm as [`codex-arsenal`](https://www.npmjs.com/packa
 | `config-session-bootstrap` | `.codex/session-config.json` | Session bootstrap and Obsidian bridge settings. |
 | `config-vscode` | `.vscode/settings.json` | VS Code settings for agent-assisted development. |
 
+### Add-ons
+
+These are opt-in: `init --yes` installs only the default `codex-md` guidance. Select an add-on in the interactive `init` prompt or pass its ID to `get`.
+
+| ID | Installs | Purpose |
+| --- | --- | --- |
+| `option-plan-counterargument` | `skills/plan-counterargument/SKILL.md` | Challenge a proposed plan and revise it when the evidence falsifies it. |
+| `option-token-efficient-execution` | `skills/token-efficient-execution/SKILL.md` | Conserve context and tool-output budget without skipping verification. |
+| `option-obsidian-session-loop` | Obsidian config, prompts, skill, and bridge sketch | Add session-note sync and meaningful-work article drafting in Obsidian. |
+
 ### Prompts
 
 | ID | Installs | Purpose |

package/lib/manifest.js

@@ -32,6 +32,39 @@ export const MANIFEST = [
     description: "VS Code settings for AI-assisted development.",
     files: [{ src: "configs/vscode/settings.json", dest: ".vscode/settings.json" }]
   },
+  {
+    id: "option-plan-counterargument",
+    category: "Add-ons",
+    label: "plan-counterargument",
+    description: "Challenge and falsify a proposed plan before implementation.",
+    files: [
+      { src: "skills/plan-counterargument/SKILL.md", dest: "skills/plan-counterargument/SKILL.md" }
+    ]
+  },
+  {
+    id: "option-token-efficient-execution",
+    category: "Add-ons",
+    label: "token-efficient-execution",
+    description: "Use focused context and tool output while preserving verification quality.",
+    files: [
+      { src: "skills/token-efficient-execution/SKILL.md", dest: "skills/token-efficient-execution/SKILL.md" }
+    ]
+  },
+  {
+    id: "option-obsidian-session-loop",
+    category: "Add-ons",
+    label: "obsidian-session-loop",
+    description: "Install the optional Obsidian session settings, notes, skill, and bridge sketch.",
+    files: [
+      { src: "configs/codex/session-config.json", dest: ".codex/session-config.json" },
+      { src: "prompts/session-bootstrap.md", dest: "prompts/session-bootstrap.md" },
+      { src: "prompts/code-style.md", dest: "prompts/code-style.md" },
+      { src: "prompts/meaningful-work.md", dest: "prompts/meaningful-work.md" },
+      { src: "skills/obsidian-session-loop/SKILL.md", dest: "skills/obsidian-session-loop/SKILL.md" },
+      { src: "plugins/obsidian-codex-bridge/README.md", dest: "plugins/obsidian-codex-bridge/README.md" },
+      { src: "plugins/obsidian-codex-bridge/plugin.json", dest: "plugins/obsidian-codex-bridge/plugin.json" }
+    ]
+  },
   {
     id: "prompt-session-bootstrap",
     category: "Prompts",

package/lib/obsidian-bridge.js

@@ -106,6 +106,10 @@ export function resolveObsidianLaunchSpec({
     throw new Error(`Obsidian note must be inside the vault: ${notePath}`);
   }
 
+  // Obsidian CLI arguments and obsidian:// URIs use vault-relative POSIX paths,
+  // even when this bridge runs on Windows.
+  const vaultRelativeFilePath = relativeFilePath.split(path.sep).join("/");
+
   const templates = {
     ...defaultLaunchTemplates(),
     ...(obsidian.launch || {})
@@ -119,7 +123,7 @@ export function resolveObsidianLaunchSpec({
       args: normalizeTemplateValue(template.args || [], {
         vaultName,
         vaultRoot,
-        filePath: relativeFilePath,
+        filePath: vaultRelativeFilePath,
         mode
       }),
       cwd: vaultRoot
@@ -128,7 +132,7 @@ export function resolveObsidianLaunchSpec({
 
   return {
     type: "uri",
-    uri: `obsidian://open?vault=${encodeURIComponent(vaultName)}&file=${encodeURIComponent(relativeFilePath)}`
+    uri: `obsidian://open?vault=${encodeURIComponent(vaultName)}&file=${encodeURIComponent(vaultRelativeFilePath)}`
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-arsenal",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "A practical arsenal of Codex plugins, skills, prompts, workflows, and configs.",
   "type": "module",
   "bin": {

package/skills/plan-counterargument/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: plan-counterargument
+description: Use when planning a Codex task and the project wants each proposed plan challenged before implementation.
+---
+
+# Plan Counterargument
+
+Before presenting or executing a multi-step plan, add a concise counterargument pass.
+
+1. State the intended outcome and the plan's key assumptions.
+2. Identify the strongest plausible reason the plan could be wrong, incomplete, too broad, or unnecessarily complex.
+3. Check the repository or task evidence that would falsify the plan.
+4. Revise the plan when the counterargument holds; otherwise, record why it does not.
+
+Keep this proportional: one focused challenge is enough for routine changes. For high-risk work, challenge scope, dependencies, failure modes, and verification separately.
+
+Do not use counterarguments to stall. The purpose is to improve the next action, not to manufacture uncertainty.

package/skills/token-efficient-execution/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: token-efficient-execution
+description: Use when a Codex task should conserve context and tool-output budget without reducing verification quality.
+---
+
+# Token-Efficient Execution
+
+Spend context only where it changes the decision.
+
+- Start with filenames, symbols, and short snippets before reading full files.
+- Prefer `rg` and targeted searches over broad recursive reads.
+- Summarize long output immediately: key facts, paths, line numbers, open questions.
+- Quote only the smallest useful error excerpt; do not return large logs.
+- Reuse already-loaded context instead of reading the same files again.
+- Batch related read-only checks when their results are needed together.
+- For handoffs, compress to goal, changed files, commands run, verification, and next risk.
+
+Context conservation never replaces verification. Read the full source when a narrow excerpt cannot establish correctness.