jarvis-journal

Journal Entry Workflow

Steps

1. Clarify type/context with user (AskUserQuestion):

   • Entry type: thought, incident-log, decision, learning, idea
   • Additional context if content is ambiguous

2. Delegate to jarvis-journal-agent:

   {
     "mode": "create",
     "content": "user's content",
     "type": "detected or clarified type",
     "context": "any additional context",
     "clarifications": "user's answers to questions"
   }
   

3. Present draft to user for approval

4. Handle response:

   • Approved → Delegate commit to jarvis-audit-agent:

     {
       "operation": "create",
       "description": "Journal entry: [brief summary]",
       "entry_id": "YYYYMMDDHHMMSS",
       "files": ["{paths.journal_jarvis}/YYYY/MM/YYYYMMDDHHMMSS.md"]
     }
     

   • Edit requested → Collect feedback, re-delegate to agent with mode: "edit"
   • Cancelled → Delete the file, no commit (no git pollution)

5. Index in memory (after successful commit):

   • Call mcp__plugin_jarvis_core__jarvis_index_file with the entry's relative vault path
   • If tool unavailable or fails, continue silently (graceful degradation)
   • This makes the entry immediately searchable via /jarvis-recall

Agent Returns

{
  "file_path": "journal/jarvis/2026/01/20260123143052.md",
  "entry_id": "20260123143052",
  "confidence": "high|medium|low",
  "tags": ["#type/thought", "#topic/jarvis"],
  "links": ["[[Related Note]]"]
}

Entry Storage

Path: {paths.journal_jarvis}/YYYY/MM/YYYYMMDDHHMMSS.md (default: journal/jarvis/YYYY/MM/YYYYMMDDHHMMSS.md)

Important

• Agent writes the file but does NOT commit
• You handle commit only after user approval
• If user cancels, delete the file to keep git history clean