Add magellan to partner-built — enterprise knowledge discovery

Magellan builds structured knowledge graphs from enterprise materials (code,
documents, transcripts, diagrams). Surfaces contradictions and open questions
as primary outputs with a full lifecycle: detect, surface, resolve, audit.

Includes 12 legacy language guides for AS400/mainframe systems (RPG, COBOL,
CL, DDS, JCL, CICS, etc.). Pure markdown + JSON, zero code dependencies.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: apardawala

partner-built/magellan/CONNECTORS.md

@@ -28,3 +28,6 @@ diagrams) and it builds the knowledge graph from those files directly.
 
 Magellan has no system requirements beyond Claude Code. It reads files directly
 using Claude's built-in capabilities — no external tools needed.
+
+> **Note:** Claude does not yet natively read DOCX, PPTX, or XLSX files. Until it
+> does, convert these to PDF before adding them to your workspace.

partner-built/magellan/README.md

@@ -15,6 +15,8 @@ claude plugin install magellan@knowledge-work-plugins
 /magellan                              Run the discovery pipeline
 /magellan:add /path/to/document.pdf    Add a file
 /magellan:add --correction "..."       Record a verbal correction
+/magellan:add --resolve c_001 "..."    Resolve a contradiction
+/magellan:add --resolve oq_003 "..."   Answer an open question
 /magellan:ask How does billing work?   Query the knowledge graph
 ```
 
@@ -55,8 +57,10 @@ On subsequent runs, only new and modified files are processed.
 ## Input Files
 
 Magellan reads anything Claude can read — text, code, markdown, CSV, JSON, YAML, XML,
-PDF, images, and meeting transcripts. For binary formats Claude can't read directly
-(DOCX, PPTX, XLSX), convert to PDF or markdown first.
+PDF, images, and meeting transcripts.
+
+> **Note:** Claude does not yet natively read DOCX, PPTX, or XLSX files. Until it
+> does, convert these to PDF before adding them to your workspace.
 
 Includes 12 language guides for legacy systems (RPG, COBOL, CL, DDS, JCL, CICS,
 Assembler/370, NATURAL/ADABAS, IDMS, Easytrieve, PL/I, REXX) that improve extraction

partner-built/magellan/commands/add.md

@@ -4,13 +4,14 @@ description: Add materials or corrections to the Magellan knowledge graph
 
 # Add Materials
 
-Add a file, directory, or correction to the knowledge graph.
+Add a file, directory, correction, or resolution to the knowledge graph.
 
 ## Usage
 
 ```
-/magellan:add <path>                Add a file or directory
-/magellan:add --correction "..."    Record a verbal correction
+/magellan:add <path>                        Add a file or directory
+/magellan:add --correction "..."            Record a verbal correction
+/magellan:add --resolve <id> "..."          Resolve a contradiction or answer a question
 ```
 
 ## Pre-Flight Check
@@ -59,8 +60,58 @@ When `--correction` is provided with a quoted string:
 3. Report what was recorded. The graph builder will detect contradictions
    on the next pipeline run.
 
+## Resolving Contradictions and Answering Questions
+
+When `--resolve <id>` is provided with a resolution note:
+
+The `<id>` can be a contradiction ID (e.g., `c_001`) or a question ID (e.g., `oq_001`).
+
+**For contradictions (c_xxx):**
+
+1. Search for the contradiction across all domains:
+   - Use Glob to find `domains/*/contradictions.json`.
+   - Read each file and find the entry matching the ID in the `active` array.
+2. Move the contradiction from `active` to `resolved`:
+   - Remove it from the `active` array.
+   - Add `resolution_note` (the quoted text), `resolved_at` (current ISO timestamp),
+     and set `status` to `"resolved"`.
+   - Append it to the `resolved` array in the same file.
+3. Write the updated file back.
+4. If the contradiction had `related_entities`, read each entity and remove the
+   `contested: true` flag if no other active contradictions reference it.
+5. Display:
+   ```
+   Resolved: c_001 (billing)
+   Resolution: "Confirmed with John Smith: threshold changed to $15k in Q4"
+   Affected entities updated: billing:manual_review_bypass
+   ```
+
+**For open questions (oq_xxx):**
+
+1. Search across all domains:
+   - Use Glob to find `domains/*/open_questions.json`.
+   - Read each file and find the matching entry in the `active` array.
+2. Move from `active` to `resolved`:
+   - Remove from `active`.
+   - Add `answer_source` (the quoted text), `answered_at` (current ISO timestamp),
+     and set `status` to `"answered"`.
+   - Append to the `resolved` array.
+3. Write the updated file back.
+4. Display:
+   ```
+   Answered: oq_003 (billing)
+   Answer: "The $10k threshold is still active per Jane Doe (Finance)"
+   ```
+
+**If the ID is not found** in any domain, display:
+```
+Not found: <id>. Use /magellan:ask to list active contradictions and questions.
+```
+
 ## Notes
 
 - Every fact traces to a source document. Corrections create a record document.
 - Follow the fact schema in file-conventions exactly.
 - For large files, extract facts in batches of 10-15 to stay within output limits.
+- Resolving a contradiction creates an audit trail — the dashboard shows both
+  active and resolved items.