cdeust/cortex/cortex-remember-global

Remember Global — Store Cross-Project Knowledge

Keywords

global, everywhere, all projects, cross-project, shared, universal, convention, standard, rule, infrastructure, policy, team agreement, always, never, architecture rule, coding standard

Overview

Store knowledge that transcends any single project into Cortex's global memory. Global memories bypass domain filtering during recall — they're visible from every project you work on. Use this for architecture rules, coding conventions, infrastructure facts, security policies, and team agreements.

Cortex auto-detects many global patterns (clean architecture, dependency injection, server addresses, etc.), but use this skill explicitly when you want to guarantee cross-project visibility.

Workflow

Step 1: Identify Cross-Project Knowledge

Good candidates for global memory:

• Architecture rules: "Always follow clean architecture — inner layers never import outer layers"
• Coding conventions: "Use UTC timestamps in all database layers"
• Infrastructure: "Production database at db.internal:5432, daily backups at 3AM UTC"
• Security policies: "Rotate API keys every 90 days, store in 1Password vault"
• Team agreements: "PRs must be under 300 lines, always include tests"
• Reusable patterns: "Use factory injection for all handler composition roots"

Not global (project-specific): bug fixes, feature decisions for one project, file-specific notes.

Step 2: Store as Global

cortex:remember({
  "content": "<clear, self-contained knowledge that applies across projects>",
  "tags": ["<category>", "<topic>"],
  "is_global": true,
  "force": true
})

Content guidelines:

• Write as a rule or fact, not a narrative: "Always use UTC" not "Today we decided to use UTC in the auth service"
• Include the why when it's a rule: "Use dependency injection because it enables testing and follows SOLID"
• Keep it universal — no project-specific file paths, PR numbers, or branch names

Step 3: Verify Global Status

The response includes:

• is_global: true — confirms cross-project visibility
• global_reason: "explicit" — stored because you explicitly requested it

Step 4: Anchor for Permanence (Optional)

Global memories are already high-value, but if they must never decay:

cortex:anchor({
  "memory_id": <id>,
  "reason": "Core architecture rule — permanent"
})

Auto-Detection

Even without is_global: true, Cortex automatically detects global content using a weighted signal classifier across 6 categories:

If the weighted score exceeds threshold 3.0, the memory is automatically global — no explicit flag needed.

Tips

• Be declarative: "Inner layers never import outer layers" is better than "We should probably avoid importing infrastructure in core"
• One rule per memory: Don't bundle 5 conventions into one memory — store each separately for better retrieval
• Tag consistently: Use architecture, convention, infrastructure, security, policy tags for easy filtering
• Review with visualization: Use cortex:open_visualization and click the "Global" filter to see all cross-project knowledge