Automation & Workflows

The Automation Stack

CodeMap provides four complementary automation tools:

• Templates: Reusable code scaffolds for consistent file creation
• Macros: Quick shell command shortcuts
• Scripts: Custom JavaScript automation for complex tasks
• Routines: Multi-step workflows combining tools, scripts, and checklists

Each layer builds on the previous, creating a flexible automation framework.

Level 0: Templates

Templates are reusable code scaffolds that help maintain consistency across your codebase. Save common file patterns (React components, API routes, test files) and deploy them instantly with proper naming and structure.

Common Use Cases

• Component boilerplate (React, Vue, Angular)
• API endpoint templates with standard error handling
• Test file scaffolds with common setup/teardown
• Configuration file templates

Example: React Component Template

import React from 'react';\n\nexport interface {{ComponentName}}Props {\n  // Add props here\n}\n\nexport const {{ComponentName}}: React.FC<{{ComponentName}}Props> = (props) => {\n  return (\n    
\n      {/* Component content */}\n    
\n  );\n};

Deploy with template-deploy to create files with proper naming conventions automatically applied.

Level 1: Macros

Macros are named shortcuts for frequently-used shell commands. Use for wrapping long commands, standardizing build/test commands, and avoiding typos in critical commands.

Common Patterns

Create macros for build commands, test suites, linting, and deployment scripts. Keep each macro focused on a single command.

Level 2: Scripts

Scripts are JavaScript files with access to the full CodeMap API. They're organized into categories: audit, build, orient, close, and utility.

Example: Circular Dependency Check

// Check for circular dependencies\nmodule.exports = async (context) => {\n  const { graph } = context\n  const cycles = graph.findCycles()\n  \n  if (cycles.length > 0) {\n    console.error(`Found ${cycles.length} circular dependencies`)\n    return { success: false, cycles }\n  }\n  \n  return { success: true }\n}

Level 3: Routines

Routines combine scripts, macros, checklists, templates, and file references into multi-step workflows. Perfect for pre-deploy checks, PR reviews, release preparations, and onboarding processes.

Real-World Example: Pre-Deploy Workflow

A comprehensive pre-deploy routine might include:

1. Checklist item: "All tests passing"
2. Run audit script: check for circular dependencies
3. Execute macro: run full test suite
4. Execute macro: build production bundle
5. Checklist item: "Deployment notes updated"

Built-In Session Workflows

CodeMap has two built-in routine-like workflows:

Session Start

1. Orient to the project
2. Check for premature termination
3. Display session checklist
4. Load project memory

Session Close

1. Run audit scripts
2. Verify code compiles
3. Create session summary
4. Write handoff notes