lyndonkl/component-extraction

component-extraction

The third level of Adler's reading methodology. Builds on structural-analysis: now that the document's unity, parts, and problems are mapped, this skill extracts atomic components — terms, propositions, arguments, solutions — section by section.

The extraction is the substrate the downstream synthesis works on. Quality here determines downstream artifact quality.

Workflow

- [ ] Step 1: Choose a reading strategy based on document size and structure
- [ ] Step 2: Initialize a per-section extraction workspace
- [ ] Step 3: For each section in turn — read it, extract terms / propositions / arguments / solutions, write to workspace, clear from context
- [ ] Step 4: Cross-reference (terms used across sections, contradictions across sections)
- [ ] Step 5: Output the consolidated extraction

Inputs

The calling agent passes:

• source: the document
• structural_output: from structural-analysis — gives the parts list and unity statement
• purpose_context: e.g., paper_pass_2_content_grasp, skill_extraction_from_methodology, evidence_mining
• domain_hint: optional

Reading strategies

Match strategy to document characteristics from structural-analysis. Don't read everything at once — that's how context windows fill and quality drops.

Strategy 1 — Section-based

When: clear sections, document under ~50 pages.

How: read one section, extract components for it, write to workspace, clear context, repeat. Each section is a unit of focused attention.

This is the default strategy. Most well-structured documents fit it.

Strategy 2 — Windowing

When: long document over ~50 pages with no clear section breaks (long-form essays, transcripts).

How: read 200-line chunks with ~20-line overlap (so context spans the boundary), extract per chunk, dedupe across chunks at the end.

Strategy 3 — Targeted

When: hybrid content where only specific sections from structural-analysis are high-value for the calling purpose.

How: read only the high-value sections (skip the rest with a note), extract intensively per relevant section.

The calling agent's purpose_context determines which sections are high-value.

What to extract per section

For each section, extract these four component types. Each gets a structured entry.

Terms (definitions; key concepts)

Words or short phrases the document defines, uses repeatedly, or relies on as load-bearing concepts. Capture:

• The term as written
• Definition (quoted from source, or "definition implicit; inferred from use" if not stated)
• Section reference

Distinguish terms-of-art (specific to this document or field) from generic terms (where the document uses an ordinary word in a normal sense — those don't need extraction).

Propositions (claims; assertions)

Statements the document makes — claims it wants the reader to accept. Capture:

• Claim text
• Supporting evidence cited (quoted or summarized) or "no support cited"
• Hedging if any (preserve the source's hedge — never promote "suggests" to "shows")

Arguments (logical sequences from premise to conclusion)

How does the document get from premise A to conclusion C? Capture:

• The premise(s)
• The conclusion
• The reasoning steps (numbered)
• Gaps where present ("step from X to Y is asserted, not derived")

Solutions (concrete examples; templates; procedures)

Anything the document provides as a model of execution — examples worked through, templates to fill, scripts to run, procedures to follow. Capture:

• The example or template (referenced, not copied wholesale)
• The context it's offered for
• What variation is allowed vs prescribed

Output structure

A consolidated extraction that the synthesis level (synthesis-application) can evaluate.

## Component Extraction Output

### Reading strategy used
{section-based | windowing | targeted}
Rationale: {why}

### Per-section extractions

#### Section 1: {name}
**Terms:**
- {term} — {definition} — {section ref}
- ...

**Propositions:**
- {claim} — {evidence or "no support"} — {hedge if any}
- ...

**Arguments:**
- Premises: {list}
  Conclusion: {claim}
  Reasoning: {steps}
  Gaps: {if any}

**Solutions:**
- {example or template} — {context} — {what's variable}

#### Section 2: {name}
... (same structure)

### Cross-section observations
- Terms used across sections (consolidated definitions)
- Contradictions: where section X says A and section Y says not-A
- Reused arguments: where the same logical move appears multiple times

Common patterns

Pattern A — Skill extraction (call from skill-creator)

purpose_context=skill_extraction_from_methodology. Each extracted component becomes a candidate for the SKILL.md being built — terms become the skill's vocabulary, propositions become its claims, arguments become its decision logic, solutions become its examples and templates.

Pattern B — Paper Pass 2 (call from paper-extractor)

purpose_context=paper_pass_2_content_grasp. Per-section extraction maps cleanly to the paper's section structure (intro / methods / results / discussion). The output feeds Pass 2's content-grasp questions: terms become unfamiliar-terms-to-gloss, propositions become the main argument, arguments become the hypothesis-evidence chain, solutions become the figure-by-figure analysis.

Pattern C — Evidence mining (call from a research-claim-map workflow)

purpose_context=evidence_mining. Propositions are the centerpiece — extract every claim with its evidence and hedge, prepare for downstream triangulation across documents.

Guardrails

1. Read one section at a time. Don't load the whole document and try to extract everything at once — context overflow degrades quality.
2. Quote when capturing. When extracting a definition or a claim, quote the source phrasing (or note "paraphrased"). Paraphrasing silently introduces drift.
3. Preserve hedging. If a proposition says "suggests" or "is consistent with," the extraction says the same. Never promote.
4. Don't extract what isn't there. If a section has no extractable terms or solutions, write {none}. Don't pad to fit the template.
5. Flag missing support. If a proposition has no cited evidence, mark it explicitly. The downstream synthesis-application gate uses this signal.

Related

• structural-analysis — Level 2, run before this. Provides the parts list this skill iterates over.
• synthesis-application — Level 4, run after this. Evaluates the components this skill produced for completeness + logic + applicability.
• research-claim-map — pairs naturally with the evidence_mining purpose; consumes propositions and triangulates.
• The skill-creator skill at skills/skill-creator/SKILL.md invokes this skill as its Step 3.
• paper-three-pass-extraction invokes this skill in Pass 2 to produce the structured per-section content used by the synthesizer.