Oculus Proficiency Test

This test validates that an agent can effectively use Oculus for navigation, reading, and editing based on the CLAUDE.md guidance.

Test Objective

Complete all tasks in the checklist below. Each task exercises a different aspect of Oculus usage.

Tasks

Bonus Tasks (Optional) [bonus-tasks]

Want to explore more advanced features? Try these optional challenges:

• Bonus 1: Version Control - Use _____history to view version history of a node you edited, then read a specific version with _____version
• Bonus 2: Fuzzy Search - Use _____fuzzy to find a node when you only partially remember the slug (try searching for "taxonomy" or similar)
• Bonus 3: Graph Exploration - Use ______explore to see the neighborhood around this test node (shows nearby nodes with diminishing detail by distance)
• Bonus 4: Tag Discovery - Use ________tagged to find all nodes with a specific tag (try pattern:test or pattern:guide)
• Bonus 5: Sandbox Practice - Visit the ${test-sandbox} node and try the sandbox-reset fence to see how executable fences work

These bonus tasks aren't graded but help you become more proficient with advanced Oculus features!

Tasks

Tasks [proficiency-test-tasks]

• Task 1: Find and Read - Use _____grep to search for nodes containing "tagging-taxonomy". View the node using ______look and extract the tag format convention.
• Task 2: Explore and Extract - Use ______look to explore the structure of cmd-poke. Find ANY YAML fence and use _____peek to extract a value from it. Document what path you used and what value you found.
• Task 3: Create Documentation - Create a new node called test-agent-notes-<identifier> where <identifier> is your session ID, name, or timestamp (e.g., test-agent-notes-claude, test-agent-notes-20260122b, or test-agent-notes-session-abc). Add a summary of what you learned about tagging conventions.
• Task 4: Link Your Work - Link your new notes node to this test node (use south direction from this node, backlink=true).
• Task 5: Update Section - Add a new H2 section to your notes node called "## Test Results" with a brief statement about what worked well. Remember: poke to the content path with append operation and include the header!
• Task 6: Complete Test - Mark all tasks above as complete using the virtual fence execute action.

How to Complete Task 6

Use the labeled fence proficiency-test-tasks to mark tasks complete:

// Mark task 0 as complete
____execute({
  fence_id: "proficiency-test-tasks",
  action: "toggle",
  params: { item_index: 0 },
  context: "Completed Task 1: Find and Read"
})

// Or check it explicitly
____execute({
  fence_id: "proficiency-test-tasks",
  action: "check",
  params: { item_index: 0 },
  context: "Completed Task 1"
})

Complete all 6 tasks in order, checking them off as you go.

Expected Skills

• Navigation: Using goto, look, grep, and search tools
• Reading: Using peek with proper path syntax
• Writing: Using poke with correct operation modes
• Graph Management: Creating nodes, linking them, tagging them
• Todo Management: Executing virtual fence actions on todo lists

Success Criteria

All checkboxes above are checked, and the test-agent-notes node exists with:

• Content about tagging conventions
• A "Test Results" section
• A south link from this node

Tips

• Review the CLAUDE.md "Oculus Navigation and Editing - How and Why" section
• Remember: to add a new section, poke to the PARENT with the header included
• Always include context parameter when poking
• Use ______look to inspect node structure before editing

Provenance

Document

• Status: 🔴 Unverified

Changelog

• 2026-01-22 15:57: Node created by mcp - Creating test task to verify CLAUDE.md Oculus guidance

East

slots:
- slug: oculus-proficiency-test-questionnaire
  context:
  - Linking questionnaire template to main test for reference
- slug: questionnaire-claude-20260122-b
  context:
  - Linking questionnaire to test instance for feedback tracking

South

slots:
- slug: test-sandbox
  context:
  - Linking sandbox to test for bonus task access
- slug: test-agent-notes-claude-20260122
  context:
  - Linking test results node to proficiency test for Task 4