Skip to content

Commit 04849f3

Browse files
apardawalaclaude
andcommitted
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>
1 parent f5b584a commit 04849f3

3 files changed

Lines changed: 63 additions & 5 deletions

File tree

partner-built/magellan/CONNECTORS.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,3 +28,6 @@ diagrams) and it builds the knowledge graph from those files directly.
2828

2929
Magellan has no system requirements beyond Claude Code. It reads files directly
3030
using Claude's built-in capabilities — no external tools needed.
31+
32+
> **Note:** Claude does not yet natively read DOCX, PPTX, or XLSX files. Until it
33+
> does, convert these to PDF before adding them to your workspace.

partner-built/magellan/README.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,8 @@ claude plugin install magellan@knowledge-work-plugins
1515
/magellan Run the discovery pipeline
1616
/magellan:add /path/to/document.pdf Add a file
1717
/magellan:add --correction "..." Record a verbal correction
18+
/magellan:add --resolve c_001 "..." Resolve a contradiction
19+
/magellan:add --resolve oq_003 "..." Answer an open question
1820
/magellan:ask How does billing work? Query the knowledge graph
1921
```
2022

@@ -55,8 +57,10 @@ On subsequent runs, only new and modified files are processed.
5557
## Input Files
5658

5759
Magellan reads anything Claude can read — text, code, markdown, CSV, JSON, YAML, XML,
58-
PDF, images, and meeting transcripts. For binary formats Claude can't read directly
59-
(DOCX, PPTX, XLSX), convert to PDF or markdown first.
60+
PDF, images, and meeting transcripts.
61+
62+
> **Note:** Claude does not yet natively read DOCX, PPTX, or XLSX files. Until it
63+
> does, convert these to PDF before adding them to your workspace.
6064
6165
Includes 12 language guides for legacy systems (RPG, COBOL, CL, DDS, JCL, CICS,
6266
Assembler/370, NATURAL/ADABAS, IDMS, Easytrieve, PL/I, REXX) that improve extraction

partner-built/magellan/commands/add.md

Lines changed: 54 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,14 @@ description: Add materials or corrections to the Magellan knowledge graph
44

55
# Add Materials
66

7-
Add a file, directory, or correction to the knowledge graph.
7+
Add a file, directory, correction, or resolution to the knowledge graph.
88

99
## Usage
1010

1111
```
12-
/magellan:add <path> Add a file or directory
13-
/magellan:add --correction "..." Record a verbal correction
12+
/magellan:add <path> Add a file or directory
13+
/magellan:add --correction "..." Record a verbal correction
14+
/magellan:add --resolve <id> "..." Resolve a contradiction or answer a question
1415
```
1516

1617
## Pre-Flight Check
@@ -59,8 +60,58 @@ When `--correction` is provided with a quoted string:
5960
3. Report what was recorded. The graph builder will detect contradictions
6061
on the next pipeline run.
6162

63+
## Resolving Contradictions and Answering Questions
64+
65+
When `--resolve <id>` is provided with a resolution note:
66+
67+
The `<id>` can be a contradiction ID (e.g., `c_001`) or a question ID (e.g., `oq_001`).
68+
69+
**For contradictions (c_xxx):**
70+
71+
1. Search for the contradiction across all domains:
72+
- Use Glob to find `domains/*/contradictions.json`.
73+
- Read each file and find the entry matching the ID in the `active` array.
74+
2. Move the contradiction from `active` to `resolved`:
75+
- Remove it from the `active` array.
76+
- Add `resolution_note` (the quoted text), `resolved_at` (current ISO timestamp),
77+
and set `status` to `"resolved"`.
78+
- Append it to the `resolved` array in the same file.
79+
3. Write the updated file back.
80+
4. If the contradiction had `related_entities`, read each entity and remove the
81+
`contested: true` flag if no other active contradictions reference it.
82+
5. Display:
83+
```
84+
Resolved: c_001 (billing)
85+
Resolution: "Confirmed with John Smith: threshold changed to $15k in Q4"
86+
Affected entities updated: billing:manual_review_bypass
87+
```
88+
89+
**For open questions (oq_xxx):**
90+
91+
1. Search across all domains:
92+
- Use Glob to find `domains/*/open_questions.json`.
93+
- Read each file and find the matching entry in the `active` array.
94+
2. Move from `active` to `resolved`:
95+
- Remove from `active`.
96+
- Add `answer_source` (the quoted text), `answered_at` (current ISO timestamp),
97+
and set `status` to `"answered"`.
98+
- Append to the `resolved` array.
99+
3. Write the updated file back.
100+
4. Display:
101+
```
102+
Answered: oq_003 (billing)
103+
Answer: "The $10k threshold is still active per Jane Doe (Finance)"
104+
```
105+
106+
**If the ID is not found** in any domain, display:
107+
```
108+
Not found: <id>. Use /magellan:ask to list active contradictions and questions.
109+
```
110+
62111
## Notes
63112

64113
- Every fact traces to a source document. Corrections create a record document.
65114
- Follow the fact schema in file-conventions exactly.
66115
- For large files, extract facts in batches of 10-15 to stay within output limits.
116+
- Resolving a contradiction creates an audit trail — the dashboard shows both
117+
active and resolved items.

0 commit comments

Comments
 (0)