Feat/token optimization

README.md

@@ -196,28 +196,42 @@ $ aspens doc sync .
 | Option | Description |
 |--------|-------------|
 | `--commits <n>` | Number of commits to analyze (default: 1) |
+| `--refresh` | Review all skills against current codebase (no git diff needed) |
 | `--install-hook` | Install git post-commit hook for auto-sync |
+| `--remove-hook` | Remove the post-commit hook |
 | `--dry-run` | Preview without writing files |
 | `--timeout <seconds>` | Claude timeout (default: 300) |
 | `--model <model>` | Claude model (e.g., sonnet, opus, haiku) |
 | `--verbose` | Show what Claude is reading in real time |
 
+### `aspens doc graph [path]`
+
+Rebuild the import graph cache. Runs automatically during `doc init` and `doc sync`, but you can trigger it manually.
+
+```bash
+aspens doc graph .
+```
+
 ### `aspens add <type> [name]`
 
-Add individual components from the bundled library.
+Add individual components from the bundled library, or create custom skills.
 
 ```bash
 aspens add agent all              # Add all 9 AI agents
 aspens add agent code-reviewer    # Add a specific agent
 aspens add agent --list           # Browse available agents
 aspens add hook skill-activation  # Add auto-triggering hooks
 aspens add command dev-docs       # Add slash commands
+aspens add skill my-convention    # Scaffold a custom skill
+aspens add skill release --from dev/release.md  # Generate from a reference doc
+aspens add skill --list           # Show existing skills
 ```
 
 | Option | Description |
 |--------|-------------|
 | `--list` | Browse available components |
-| `--force` | Overwrite existing files |
+| `--from <file>` | Generate a skill from a reference document (skills only) |
+| `--force` | Overwrite existing skills |
 
 ### `aspens customize agents`
 

bin/cli.js

@@ -70,6 +70,7 @@ function showWelcome() {
     ${pc.yellow('--mode')} ${pc.dim('<mode>')}       all, chunked, base-only     ${pc.yellow('--timeout')} ${pc.dim('<s>')}  Seconds per call
     ${pc.yellow('--strategy')} ${pc.dim('<s>')}    improve, rewrite, skip      ${pc.yellow('--json')}      JSON output (scan)
     ${pc.yellow('--no-hooks')}         Skip hook installation       ${pc.yellow('--hooks-only')}  Update hooks only
+    ${pc.yellow('--no-graph')}         Skip import graph analysis
 
   ${pc.bold('Typical Workflow')}
     ${pc.dim('$')} aspens scan                              ${pc.dim('1. See what\'s in your repo')}
@@ -121,6 +122,7 @@ program
   .option('--json', 'Output as JSON')
   .option('--domains <domains>', 'Additional domains to include (comma-separated)')
   .option('--verbose', 'Show diagnostic output')
+  .option('--no-graph', 'Skip import graph analysis')
   .action(scanCommand);
 
 // Doc commands
@@ -143,6 +145,7 @@ doc
   .option('--verbose', 'Show what Claude is reading/doing in real time')
   .option('--no-hooks', 'Skip hook/rules/settings installation')
   .option('--hooks-only', 'Skip skill generation, just install/update hooks')
+  .option('--no-graph', 'Skip import graph analysis')
   .action(docInitCommand);
 
 doc
@@ -157,6 +160,7 @@ doc
   .option('--timeout <seconds>', 'Claude timeout in seconds', parseTimeout, 300)
   .option('--model <model>', 'Claude model to use (e.g., sonnet, opus, haiku)')
   .option('--verbose', 'Show what Claude is reading/doing in real time')
+  .option('--no-graph', 'Skip import graph analysis')
   .action((path, options) => {
     checkMissingHooks(resolve(path));
     return docSyncCommand(path, options);

src/commands/add.js

@@ -199,6 +199,27 @@ function addResource(repoPath, resourceType, name, available) {
 
   copyFileSync(sourceFile, targetFile);
   console.log(`  ${pc.green('+')} ${resourceType.targetDir}/${resource.fileName}`);
+
+  // Plan/execute agents need dev/ gitignored for plan storage
+  if (name === 'plan' || name === 'execute') {
+    ensureDevGitignore(repoPath);
+  }
+}
+
+function ensureDevGitignore(repoPath) {
+  try {
+    const gitignorePath = join(repoPath, '.gitignore');
+    if (existsSync(gitignorePath)) {
+      const content = readFileSync(gitignorePath, 'utf8');
+      if (/^dev\/$/m.test(content)) return; // already present
+      writeFileSync(gitignorePath, content.trimEnd() + '\ndev/\n', 'utf8');
+    } else {
+      writeFileSync(gitignorePath, 'dev/\n', 'utf8');
+    }
+    console.log(`  ${pc.green('+')} Added ${pc.cyan('dev/')} to .gitignore (used for plan storage)`);
+  } catch (err) {
+    throw new CliError(`Failed to update .gitignore: ${err.message}. Check file permissions.`);
+  }
 }
 
 // --- Custom skill ---
@@ -354,6 +375,7 @@ ${refContent}
       allowedTools: ['Read', 'Glob', 'Grep'],
       verbose,
       model: options.model || null,
+      maxTokens: 8000,
       onActivity: verbose ? (msg) => genSpinner.message(pc.dim(msg)) : null,
     });
   } catch (err) {

src/commands/customize.js

@@ -70,6 +70,7 @@ export async function customizeCommand(what, options) {
         allowedTools: READ_ONLY_TOOLS,
         verbose,
         model: options.model || null,
+        maxTokens: 8000,
         onActivity: verbose ? (msg) => agentSpinner.message(pc.dim(msg)) : null,
       });