Tools

TaskSurf is an AI-native task management platform that can export your entire workspace -- tasks, team context, agent configurations -- as a SurfContext-conformant package. The exported CONTEXT.md and .context/ directory can be dropped directly into any code repository.

• Generates ARDS v2.0 conformant output
• Includes version ledger for change tracking
• Exports agent definitions with proper frontmatter
• Maps team knowledge to .context/docs/ format

The SurfContext CLI will provide quick project scaffolding, platform file generation, and structure validation from the command line.

# Initialize a new SurfContext project
npx surfcontext init

# Generate platform files from CONTEXT.md
npx surfcontext generate

# Validate your SurfContext structure
npx surfcontext validate

Planned features:

• init -- Scaffold a new SurfContext project with interactive prompts
• generate -- Generate platform files from CONTEXT.md using surfcontext.json config
• validate -- Check project structure against ARDS v2.0 requirements
• sync -- Detect drift between canonical and generated files

SurfContext requires no dependencies or tooling. You can set up a conforming project with just a text editor and a terminal.

# 1. Create the root context
touch CONTEXT.md

# 2. Create the context directory structure
mkdir -p .context/agents .context/docs .context/skills

# 3. Create the manifest
touch surfcontext.json

# 4. (Optional) Generate platform files
cp CONTEXT.md CLAUDE.md
cp CONTEXT.md AGENTS.md

See the Getting Started guide for complete file content examples, or the specification for the full format reference.