docs: integration tools — cross-reference graph, concept index, research digest

Codex-built tooling: cross-reference graph, concept index with build script,
and research integrator that extracted 142 scholars, 175 bibliography items,
4 contradiction topics, and coverage maps for Paper 009 planning.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Mortdecai
2026-04-03 08:31:20 -04:00
parent d34f447e1f
commit f654b30de9
18 changed files with 12535 additions and 0 deletions
+558
View File
@@ -0,0 +1,558 @@
#!/usr/bin/env python3
"""Build a concept index and glossary for the VIBECODE-THEORY corpus."""
from __future__ import annotations
import json
import re
from collections import defaultdict
from dataclasses import dataclass
from pathlib import Path
ROOT = Path(__file__).resolve().parents[2]
OUT_DIR = Path(__file__).resolve().parent
@dataclass
class Document:
doc_id: str
title: str
path: Path
text: str
supersedes: str | None
CONCEPTS = [
{
"name": "Vibe Coding",
"aliases": ["vibe coding"],
"introduced_in": "001",
"status": "active",
"related_concepts": ["Social-Cognitive Framework", "Mental Model Accuracy", "Meta-Skill Argument"],
},
{
"name": "Social-Cognitive Framework",
"aliases": ["social-cognitive framework", "vibe coding as social skill", "social-cognitive processes"],
"introduced_in": "004",
"status": "active",
"related_concepts": ["Vibe Coding", "Mental Model Accuracy", "Adaptive Communication", "Collaboration Management"],
},
{
"name": "Mental Model Accuracy",
"aliases": ["mental model accuracy", "mental model"],
"introduced_in": "001",
"status": "active",
"related_concepts": ["Social-Cognitive Framework", "Adaptive Communication", "Collaboration Management"],
},
{
"name": "Adaptive Communication",
"aliases": ["adaptive communication", "constraint calibration", "register matching"],
"introduced_in": "001",
"status": "active",
"related_concepts": ["Social-Cognitive Framework", "Mental Model Accuracy", "Collaboration Management"],
},
{
"name": "Collaboration Management",
"aliases": ["collaboration management", "task decomposition", "trust calibration", "recovery"],
"introduced_in": "001",
"status": "active",
"related_concepts": ["Social-Cognitive Framework", "Adaptive Communication", "Technical Foundation"],
},
{
"name": "Technical Foundation",
"aliases": ["technical foundation", "technical expertise"],
"introduced_in": "001",
"status": "active",
"related_concepts": ["Vibe Coding", "Collaboration Management", "Meta-Skill Argument"],
},
{
"name": "Neurodivergence Note",
"aliases": ["neurodivergence note", "neurodivergence hypothesis"],
"introduced_in": "001",
"status": "open question",
"related_concepts": ["Social-Cognitive Framework"],
},
{
"name": "Shelf-Life Problem",
"aliases": ["shelf-life problem", "shelf life problem"],
"introduced_in": "003",
"status": "active",
"related_concepts": ["Meta-Skill Argument", "Infrastructure Threshold"],
},
{
"name": "Meta-Skill Argument",
"aliases": ["meta-skill argument", "meta-skill"],
"introduced_in": "004",
"status": "active",
"related_concepts": ["Shelf-Life Problem", "Vibe Coding", "Social-Cognitive Framework"],
},
{
"name": "Cognitive Surplus",
"aliases": ["cognitive surplus", "surplus of cognition", "the cognitive surplus"],
"introduced_in": "002",
"status": "active",
"related_concepts": ["Agricultural Parallel", "Cognition as a Commodity", "Automation Spiral"],
},
{
"name": "Agricultural Parallel",
"aliases": ["agricultural parallel", "agricultural analogy"],
"introduced_in": "002",
"status": "active",
"related_concepts": ["Cognitive Surplus", "Green Revolution", "Feudal Internet", "Dependency Trap"],
},
{
"name": "Dual Cognition Problem",
"aliases": ["dual cognition problem", "the dual cognition problem"],
"introduced_in": "002",
"status": "active",
"related_concepts": ["Cognitive Preference Shift", "Cognitive Atrophy", "Cognitive Surplus"],
},
{
"name": "Cognitive Atrophy",
"aliases": ["cognitive atrophy", "capability loss"],
"introduced_in": "002",
"status": "open question",
"related_concepts": ["Dual Cognition Problem", "Cognitive Preference Shift", "Biological Ratchet"],
},
{
"name": "Green Revolution",
"aliases": ["green revolution"],
"introduced_in": "002",
"status": "active",
"related_concepts": ["Agricultural Parallel", "Feudal Internet"],
},
{
"name": "Feudal Internet",
"aliases": ["feudal internet"],
"introduced_in": "002",
"status": "active",
"related_concepts": ["Agricultural Parallel", "Dependency Trap", "Cognition as a Commodity"],
},
{
"name": "Dependency Trap",
"aliases": ["dependency trap", "future 3: the dependency trap"],
"introduced_in": "002",
"status": "active",
"related_concepts": ["Feudal Internet", "Cognitive Atrophy", "Y2K Parallel"],
},
{
"name": "Automation Spiral",
"aliases": ["automation spiral"],
"introduced_in": "003",
"status": "active",
"related_concepts": ["Cognitive Surplus", "Feedback Loop", "Master-Apprentice Parallel"],
},
{
"name": "Cognitive Preference Shift",
"aliases": ["cognitive preference shift", "preference shift"],
"introduced_in": "003",
"status": "active",
"related_concepts": ["Dual Cognition Problem", "Cognitive Atrophy", "Biological Ratchet"],
},
{
"name": "Cognition as a Commodity",
"aliases": ["cognition as a commodity", "cognition-as-commodity framing"],
"introduced_in": "005",
"status": "active",
"related_concepts": ["Cognitive Surplus", "Feudal Internet", "Information/Cognition Resource Hierarchy"],
},
{
"name": "Y2K Parallel",
"aliases": ["y2k parallel", "ai y2k moment", "y2k moment"],
"introduced_in": "005",
"status": "active",
"related_concepts": ["Dependency Trap", "Infrastructure Threshold", "Cognitive Surplus"],
},
{
"name": "Information/Cognition Resource Hierarchy",
"aliases": ["information and cognition as resources", "resource hierarchy"],
"introduced_in": "005",
"status": "active",
"related_concepts": ["Cognition as a Commodity", "Knowledge Unification"],
},
{
"name": "Feedback Loop",
"aliases": ["feedback loop"],
"introduced_in": "006",
"status": "active",
"related_concepts": ["Automation Spiral", "Master-Apprentice Parallel", "Niche Construction"],
},
{
"name": "Master-Apprentice Parallel",
"aliases": ["master-apprentice parallel", "master-apprentice relationship"],
"introduced_in": "006",
"status": "active",
"related_concepts": ["Feedback Loop", "Automation Spiral", "The Golem"],
},
{
"name": "Niche Construction",
"aliases": ["niche construction"],
"introduced_in": "006",
"status": "active",
"related_concepts": ["Feedback Loop", "Recursion Observation"],
},
{
"name": "Theological Thread",
"aliases": ["theological thread"],
"introduced_in": "006",
"status": "active",
"related_concepts": ["Prometheus", "Knowledge Unification", "Recursion Observation"],
},
{
"name": "Recursion Observation",
"aliases": ["recursion observation", "cosmological → biological → linguistic → computational"],
"introduced_in": "006",
"status": "open question",
"related_concepts": ["Theological Thread", "Niche Construction", "Knowledge Unification"],
},
{
"name": "Infrastructure Threshold",
"aliases": ["infrastructure threshold"],
"introduced_in": "007",
"status": "active",
"related_concepts": ["Biological Ratchet", "Premature Dependencies", "Y2K Parallel"],
},
{
"name": "Premature Dependencies",
"aliases": ["premature dependencies", "dependency waiting for its enabling technology"],
"introduced_in": "007",
"status": "active",
"related_concepts": ["Infrastructure Threshold", "Biological Ratchet"],
},
{
"name": "Biological Ratchet",
"aliases": ["biological ratchet", "dependency ratchet", "ratchet thesis"],
"introduced_in": "007",
"status": "active",
"related_concepts": ["Infrastructure Threshold", "Cognitive Preference Shift", "Knowledge Unification"],
},
{
"name": "Dependency Chain",
"aliases": ["dependency chain"],
"introduced_in": "007",
"status": "active",
"related_concepts": ["Biological Ratchet", "Knowledge Unification", "Cheating Frame"],
},
{
"name": "Knowledge Unification",
"aliases": ["knowledge unification", "unification thesis", "unification of human knowledge", "the dependency chain as knowledge unification"],
"introduced_in": "008",
"status": "active",
"related_concepts": ["Dependency Chain", "Singularity as Compilation", "Integration Layer"],
},
{
"name": "Singularity as Compilation",
"aliases": ["singularity as compilation", "compilation not transcendence", "compilation, not transcendence"],
"introduced_in": "008",
"status": "active",
"related_concepts": ["Knowledge Unification", "Integration Layer", "Cheating Frame"],
},
{
"name": "Integration Layer",
"aliases": ["integration layer"],
"introduced_in": "008",
"status": "active",
"related_concepts": ["Knowledge Unification", "Singularity as Compilation", "Existential Purpose of the Chain"],
},
{
"name": "Ship of Theseus Problem",
"aliases": ["ship of theseus problem", "identity problem", "species identity problem", "the identity problem"],
"introduced_in": "008",
"status": "active",
"related_concepts": ["Continuity Argument", "Identity Argument", "Pragmatic Argument"],
},
{
"name": "Continuity Argument",
"aliases": ["continuity argument", "the continuity argument"],
"introduced_in": "008",
"status": "active",
"related_concepts": ["Ship of Theseus Problem", "Identity Argument", "Pragmatic Argument"],
},
{
"name": "Identity Argument",
"aliases": ["identity argument", "essentialist", "the identity argument"],
"introduced_in": "008",
"status": "active",
"related_concepts": ["Ship of Theseus Problem", "Continuity Argument", "Pragmatic Argument"],
},
{
"name": "Pragmatic Argument",
"aliases": ["pragmatic argument", "the pragmatic argument"],
"introduced_in": "008",
"status": "active",
"related_concepts": ["Ship of Theseus Problem", "Continuity Argument", "Identity Argument"],
},
{
"name": "Cheating Frame",
"aliases": ["did we cheat", "cheating frame"],
"introduced_in": "008",
"status": "active",
"related_concepts": ["Dependency Chain", "Singularity as Compilation", "Existential Purpose of the Chain"],
},
{
"name": "Existential Purpose of the Chain",
"aliases": ["existential purpose of the dependency chain", "existential purpose", "the existential purpose of the dependency chain"],
"introduced_in": "008",
"status": "active",
"related_concepts": ["Integration Layer", "Cheating Frame", "Knowledge Unification"],
},
{
"name": "Eve's Apple",
"aliases": ["eve's apple"],
"introduced_in": "eves-apple",
"status": "reference allegory",
"related_concepts": ["Cognitive Preference Shift", "Dependency Chain"],
},
{
"name": "Pandora's Box",
"aliases": ["pandora's box"],
"introduced_in": "pandoras-box",
"status": "reference allegory",
"related_concepts": ["Dependency Chain", "Automation Spiral"],
},
{
"name": "Prometheus",
"aliases": ["prometheus"],
"introduced_in": "prometheus",
"status": "reference allegory",
"related_concepts": ["Theological Thread", "Dependency Chain", "Cheating Frame"],
},
{
"name": "Sorcerer's Apprentice",
"aliases": ["sorcerer's apprentice"],
"introduced_in": "sorcerers-apprentice",
"status": "reference allegory",
"related_concepts": ["Automation Spiral", "Feedback Loop", "Dependency Chain"],
},
{
"name": "The Golem",
"aliases": ["the golem", "golem"],
"introduced_in": "the-golem",
"status": "reference allegory",
"related_concepts": ["Master-Apprentice Parallel", "Dependency Chain"],
},
{
"name": "Faustian Bargain",
"aliases": ["faustian bargain", "faust"],
"introduced_in": "faust",
"status": "reference allegory",
"related_concepts": ["Feedback Loop", "Cognitive Preference Shift"],
},
{
"name": "Icarus",
"aliases": ["icarus"],
"introduced_in": "icarus",
"status": "reference allegory",
"related_concepts": ["Shelf-Life Problem", "Infrastructure Threshold"],
},
{
"name": "Tower of Babel",
"aliases": ["tower of babel", "babel"],
"introduced_in": "tower-of-babel",
"status": "reference allegory",
"related_concepts": ["Dependency Chain", "Knowledge Unification"],
},
]
def clean_text(text: str) -> str:
text = text.replace("\r\n", "\n")
return text
def load_documents() -> dict[str, Document]:
docs: dict[str, Document] = {}
for path in sorted(ROOT.glob("00*.md")):
text = clean_text(path.read_text(encoding="utf-8"))
title_match = re.search(r"^#\s+Paper\s+(\d{3}):\s*(.+)$", text, re.MULTILINE)
supersedes_match = re.search(r"^\*\*Supersedes:\*\*\s*Paper\s+(\d{3})", text, re.MULTILINE)
if not title_match:
continue
doc_id = title_match.group(1)
docs[doc_id] = Document(
doc_id=doc_id,
title=title_match.group(2).strip(),
path=path,
text=text,
supersedes=supersedes_match.group(1) if supersedes_match else None,
)
for path in sorted((ROOT / "allegorical").glob("*.md")):
text = clean_text(path.read_text(encoding="utf-8"))
title_match = re.search(r"^#\s+(.+)$", text, re.MULTILINE)
doc_id = path.stem
docs[doc_id] = Document(
doc_id=doc_id,
title=title_match.group(1).strip() if title_match else path.stem,
path=path,
text=text,
supersedes=None,
)
return docs
def paragraphs(text: str) -> list[str]:
return [p.strip() for p in re.split(r"\n\s*\n", text) if p.strip()]
def sentences(text: str) -> list[str]:
normalized = re.sub(r"\s+", " ", text.strip())
return [s.strip() for s in re.split(r"(?<=[.!?])\s+", normalized) if s.strip()]
def alias_present(text: str, alias: str) -> bool:
pattern = r"\b" + re.escape(alias.lower()) + r"\b"
return re.search(pattern, text.lower()) is not None
def extract_section(text: str, heading: str) -> str:
pattern = rf"^##+\s+{re.escape(heading)}\s*$"
match = re.search(pattern, text, re.MULTILINE | re.IGNORECASE)
if not match:
return ""
start = match.end()
next_heading = re.search(r"^##+\s+", text[start:], re.MULTILINE)
end = start + next_heading.start() if next_heading else len(text)
return text[start:end].strip()
def first_matching_sentence(doc: Document, aliases: list[str]) -> str:
for alias in aliases:
section = extract_section(doc.text, alias)
if section:
for paragraph in paragraphs(section):
if paragraph.startswith("#"):
continue
for sentence in sentences(paragraph):
if len(sentence) >= 40:
return sentence
for paragraph in paragraphs(doc.text):
if paragraph.startswith("#") or paragraph.startswith("**Authors:**") or paragraph.startswith("**Date:**"):
continue
for sentence in sentences(paragraph):
if any(alias_present(sentence, alias) for alias in aliases) and len(sentence) >= 40:
return sentence
return "Definition sentence not found in source text."
def find_mentions(docs: dict[str, Document], aliases: list[str]) -> list[str]:
refs: list[str] = []
for doc_id, doc in docs.items():
if any(alias_present(doc.text, alias) for alias in aliases):
refs.append(doc_id)
return refs
def find_revisions(docs: dict[str, Document], concept: dict, mentions: list[str]) -> list[str]:
introduced_in = concept["introduced_in"]
revisions: list[str] = []
for doc_id in mentions:
doc = docs[doc_id]
if doc.supersedes == introduced_in:
revisions.append(doc_id)
return sorted(revisions)
def find_challenges(docs: dict[str, Document], concept: dict, mentions: list[str]) -> list[str]:
aliases = [concept["name"]] + concept["aliases"]
challenged: list[str] = []
for doc_id in mentions:
if doc_id == concept["introduced_in"]:
continue
doc = docs[doc_id]
section = extract_section(doc.text, "Relationship to Prior Papers")
open_q = extract_section(doc.text, "Open Questions") + "\n" + extract_section(doc.text, "Open Questions for Paper 007") + "\n" + extract_section(doc.text, "Open Questions for Paper 009")
corpus = f"{section}\n{open_q}\n{doc.text[:3000]}"
if any(alias_present(corpus, alias) for alias in aliases) and re.search(
r"challenge|critic|rebuttal|unfalsif|weak|bounded|downgrade|unknown",
corpus,
re.IGNORECASE,
):
challenged.append(doc_id)
return sorted(set(challenged))
def mermaid_id(name: str) -> str:
return "c_" + re.sub(r"[^a-z0-9]+", "_", name.lower()).strip("_")
def build_index() -> dict[str, list[dict]]:
docs = load_documents()
items: list[dict] = []
for concept in CONCEPTS:
aliases = [concept["name"]] + concept["aliases"]
intro_doc = docs[concept["introduced_in"]]
mentions = find_mentions(docs, aliases)
revised_in = find_revisions(docs, concept, mentions)
challenged_in = find_challenges(docs, concept, mentions)
referenced_in = [doc_id for doc_id in mentions if doc_id != concept["introduced_in"] and doc_id not in revised_in]
definition = first_matching_sentence(intro_doc, aliases)
items.append(
{
"name": concept["name"],
"aliases": sorted(set(concept["aliases"])),
"introduced_in": concept["introduced_in"],
"definition": definition,
"revised_in": revised_in,
"challenged_in": challenged_in,
"referenced_in": referenced_in,
"status": concept["status"],
"related_concepts": concept["related_concepts"],
}
)
return {"concepts": items}
def write_glossary(index: dict[str, list[dict]]) -> None:
lines = ["# VIBECODE-THEORY Glossary", ""]
for item in sorted(index["concepts"], key=lambda x: x["name"].lower()):
lines.extend(
[
f"## {item['name']}",
f"Origin: {item['introduced_in']}",
f"Status: {item['status']}",
f"Aliases: {', '.join(item['aliases']) if item['aliases'] else 'None'}",
item["definition"],
f"Revised in: {', '.join(item['revised_in']) if item['revised_in'] else 'None'}",
f"Challenged in: {', '.join(item['challenged_in']) if item['challenged_in'] else 'None'}",
f"Referenced in: {', '.join(item['referenced_in']) if item['referenced_in'] else 'None'}",
f"Related concepts: {', '.join(item['related_concepts']) if item['related_concepts'] else 'None'}",
"",
]
)
(OUT_DIR / "glossary.md").write_text("\n".join(lines), encoding="utf-8")
def write_mermaid(index: dict[str, list[dict]]) -> None:
lines = ["graph TD"]
for item in index["concepts"]:
lines.append(f' {mermaid_id(item["name"])}["{item["name"]}"]')
seen: set[tuple[str, str]] = set()
for item in index["concepts"]:
for related in item["related_concepts"]:
edge = tuple(sorted((item["name"], related)))
if edge in seen:
continue
seen.add(edge)
lines.append(
f" {mermaid_id(item['name'])} -->|relates to| {mermaid_id(related)}"
)
(OUT_DIR / "concept_map.mermaid").write_text("\n".join(lines) + "\n", encoding="utf-8")
def main() -> None:
index = build_index()
(OUT_DIR / "index.json").write_text(json.dumps(index, indent=2) + "\n", encoding="utf-8")
write_glossary(index)
write_mermaid(index)
print(f"Indexed {len(index['concepts'])} concepts.")
print(f"Wrote {OUT_DIR / 'index.json'}")
print(f"Wrote {OUT_DIR / 'glossary.md'}")
print(f"Wrote {OUT_DIR / 'concept_map.mermaid'}")
if __name__ == "__main__":
main()
+131
View File
@@ -0,0 +1,131 @@
graph TD
c_vibe_coding["Vibe Coding"]
c_social_cognitive_framework["Social-Cognitive Framework"]
c_mental_model_accuracy["Mental Model Accuracy"]
c_adaptive_communication["Adaptive Communication"]
c_collaboration_management["Collaboration Management"]
c_technical_foundation["Technical Foundation"]
c_neurodivergence_note["Neurodivergence Note"]
c_shelf_life_problem["Shelf-Life Problem"]
c_meta_skill_argument["Meta-Skill Argument"]
c_cognitive_surplus["Cognitive Surplus"]
c_agricultural_parallel["Agricultural Parallel"]
c_dual_cognition_problem["Dual Cognition Problem"]
c_cognitive_atrophy["Cognitive Atrophy"]
c_green_revolution["Green Revolution"]
c_feudal_internet["Feudal Internet"]
c_dependency_trap["Dependency Trap"]
c_automation_spiral["Automation Spiral"]
c_cognitive_preference_shift["Cognitive Preference Shift"]
c_cognition_as_a_commodity["Cognition as a Commodity"]
c_y2k_parallel["Y2K Parallel"]
c_information_cognition_resource_hierarchy["Information/Cognition Resource Hierarchy"]
c_feedback_loop["Feedback Loop"]
c_master_apprentice_parallel["Master-Apprentice Parallel"]
c_niche_construction["Niche Construction"]
c_theological_thread["Theological Thread"]
c_recursion_observation["Recursion Observation"]
c_infrastructure_threshold["Infrastructure Threshold"]
c_premature_dependencies["Premature Dependencies"]
c_biological_ratchet["Biological Ratchet"]
c_dependency_chain["Dependency Chain"]
c_knowledge_unification["Knowledge Unification"]
c_singularity_as_compilation["Singularity as Compilation"]
c_integration_layer["Integration Layer"]
c_ship_of_theseus_problem["Ship of Theseus Problem"]
c_continuity_argument["Continuity Argument"]
c_identity_argument["Identity Argument"]
c_pragmatic_argument["Pragmatic Argument"]
c_cheating_frame["Cheating Frame"]
c_existential_purpose_of_the_chain["Existential Purpose of the Chain"]
c_eve_s_apple["Eve's Apple"]
c_pandora_s_box["Pandora's Box"]
c_prometheus["Prometheus"]
c_sorcerer_s_apprentice["Sorcerer's Apprentice"]
c_the_golem["The Golem"]
c_faustian_bargain["Faustian Bargain"]
c_icarus["Icarus"]
c_tower_of_babel["Tower of Babel"]
c_vibe_coding -->|relates to| c_social_cognitive_framework
c_vibe_coding -->|relates to| c_mental_model_accuracy
c_vibe_coding -->|relates to| c_meta_skill_argument
c_social_cognitive_framework -->|relates to| c_mental_model_accuracy
c_social_cognitive_framework -->|relates to| c_adaptive_communication
c_social_cognitive_framework -->|relates to| c_collaboration_management
c_mental_model_accuracy -->|relates to| c_adaptive_communication
c_mental_model_accuracy -->|relates to| c_collaboration_management
c_adaptive_communication -->|relates to| c_collaboration_management
c_collaboration_management -->|relates to| c_technical_foundation
c_technical_foundation -->|relates to| c_vibe_coding
c_technical_foundation -->|relates to| c_meta_skill_argument
c_neurodivergence_note -->|relates to| c_social_cognitive_framework
c_shelf_life_problem -->|relates to| c_meta_skill_argument
c_shelf_life_problem -->|relates to| c_infrastructure_threshold
c_meta_skill_argument -->|relates to| c_social_cognitive_framework
c_cognitive_surplus -->|relates to| c_agricultural_parallel
c_cognitive_surplus -->|relates to| c_cognition_as_a_commodity
c_cognitive_surplus -->|relates to| c_automation_spiral
c_agricultural_parallel -->|relates to| c_green_revolution
c_agricultural_parallel -->|relates to| c_feudal_internet
c_agricultural_parallel -->|relates to| c_dependency_trap
c_dual_cognition_problem -->|relates to| c_cognitive_preference_shift
c_dual_cognition_problem -->|relates to| c_cognitive_atrophy
c_dual_cognition_problem -->|relates to| c_cognitive_surplus
c_cognitive_atrophy -->|relates to| c_cognitive_preference_shift
c_cognitive_atrophy -->|relates to| c_biological_ratchet
c_green_revolution -->|relates to| c_feudal_internet
c_feudal_internet -->|relates to| c_dependency_trap
c_feudal_internet -->|relates to| c_cognition_as_a_commodity
c_dependency_trap -->|relates to| c_cognitive_atrophy
c_dependency_trap -->|relates to| c_y2k_parallel
c_automation_spiral -->|relates to| c_feedback_loop
c_automation_spiral -->|relates to| c_master_apprentice_parallel
c_cognitive_preference_shift -->|relates to| c_biological_ratchet
c_cognition_as_a_commodity -->|relates to| c_information_cognition_resource_hierarchy
c_y2k_parallel -->|relates to| c_infrastructure_threshold
c_y2k_parallel -->|relates to| c_cognitive_surplus
c_information_cognition_resource_hierarchy -->|relates to| c_knowledge_unification
c_feedback_loop -->|relates to| c_master_apprentice_parallel
c_feedback_loop -->|relates to| c_niche_construction
c_master_apprentice_parallel -->|relates to| c_the_golem
c_niche_construction -->|relates to| c_recursion_observation
c_theological_thread -->|relates to| c_prometheus
c_theological_thread -->|relates to| c_knowledge_unification
c_theological_thread -->|relates to| c_recursion_observation
c_recursion_observation -->|relates to| c_knowledge_unification
c_infrastructure_threshold -->|relates to| c_biological_ratchet
c_infrastructure_threshold -->|relates to| c_premature_dependencies
c_premature_dependencies -->|relates to| c_biological_ratchet
c_biological_ratchet -->|relates to| c_knowledge_unification
c_dependency_chain -->|relates to| c_biological_ratchet
c_dependency_chain -->|relates to| c_knowledge_unification
c_dependency_chain -->|relates to| c_cheating_frame
c_knowledge_unification -->|relates to| c_singularity_as_compilation
c_knowledge_unification -->|relates to| c_integration_layer
c_singularity_as_compilation -->|relates to| c_integration_layer
c_singularity_as_compilation -->|relates to| c_cheating_frame
c_integration_layer -->|relates to| c_existential_purpose_of_the_chain
c_ship_of_theseus_problem -->|relates to| c_continuity_argument
c_ship_of_theseus_problem -->|relates to| c_identity_argument
c_ship_of_theseus_problem -->|relates to| c_pragmatic_argument
c_continuity_argument -->|relates to| c_identity_argument
c_continuity_argument -->|relates to| c_pragmatic_argument
c_identity_argument -->|relates to| c_pragmatic_argument
c_cheating_frame -->|relates to| c_existential_purpose_of_the_chain
c_existential_purpose_of_the_chain -->|relates to| c_knowledge_unification
c_eve_s_apple -->|relates to| c_cognitive_preference_shift
c_eve_s_apple -->|relates to| c_dependency_chain
c_pandora_s_box -->|relates to| c_dependency_chain
c_pandora_s_box -->|relates to| c_automation_spiral
c_prometheus -->|relates to| c_dependency_chain
c_prometheus -->|relates to| c_cheating_frame
c_sorcerer_s_apprentice -->|relates to| c_automation_spiral
c_sorcerer_s_apprentice -->|relates to| c_feedback_loop
c_sorcerer_s_apprentice -->|relates to| c_dependency_chain
c_the_golem -->|relates to| c_dependency_chain
c_faustian_bargain -->|relates to| c_feedback_loop
c_faustian_bargain -->|relates to| c_cognitive_preference_shift
c_icarus -->|relates to| c_shelf_life_problem
c_icarus -->|relates to| c_infrastructure_threshold
c_tower_of_babel -->|relates to| c_dependency_chain
c_tower_of_babel -->|relates to| c_knowledge_unification
+471
View File
@@ -0,0 +1,471 @@
# VIBECODE-THEORY Glossary
## Adaptive Communication
Origin: 001
Status: active
Aliases: adaptive communication, constraint calibration, register matching
- **Constraint calibration** — knowing when to specify tightly and when to leave room.
Revised in: 004
Challenged in: 003
Referenced in: 003
Related concepts: Social-Cognitive Framework, Mental Model Accuracy, Collaboration Management
## Agricultural Parallel
Origin: 002
Status: active
Aliases: agricultural analogy, agricultural parallel
The agricultural parallel: early farmers gained knowledge of seasons, irrigation, selective breeding, and storage that foragers didn't have.
Revised in: 005
Challenged in: 005, 006, 008
Referenced in: 003, 006, 008
Related concepts: Cognitive Surplus, Green Revolution, Feudal Internet, Dependency Trap
## Automation Spiral
Origin: 003
Status: active
Aliases: automation spiral
The Dependency Trap is "humans can't function without AI." The Automation Spiral is "AI functions without humans." The Dependency Trap still needs people in the loop, just helpless ones.
Revised in: None
Challenged in: 005, 006, 008
Referenced in: 005, 006, 007, 008, sorcerers-apprentice
Related concepts: Cognitive Surplus, Feedback Loop, Master-Apprentice Parallel
## Biological Ratchet
Origin: 007
Status: active
Aliases: biological ratchet, dependency ratchet, ratchet thesis
They outcompete organisms that maintain redundant internal capacity "just in case." The dependency ratchet isn't a bug — it's the core mechanism by which complexity increases.
Revised in: None
Challenged in: 008
Referenced in: 008
Related concepts: Infrastructure Threshold, Cognitive Preference Shift, Knowledge Unification
## Cheating Frame
Origin: 008
Status: active
Aliases: cheating frame, did we cheat
The question "did we cheat?" assumes there's a version of the game where we don't.
Revised in: None
Challenged in: None
Referenced in: None
Related concepts: Dependency Chain, Singularity as Compilation, Existential Purpose of the Chain
## Cognition as a Commodity
Origin: 005
Status: active
Aliases: cognition as a commodity, cognition-as-commodity framing
This revision does three things: stress-tests the agricultural analogy and draws its limits, adds a concrete economic mechanism (cognition as a commodity with a collapsing price), introduces the Y2K parallel for the dependency argument, and adds the missing fourth future.
Revised in: None
Challenged in: None
Referenced in: None
Related concepts: Cognitive Surplus, Feudal Internet, Information/Cognition Resource Hierarchy
## Cognitive Atrophy
Origin: 002
Status: open question
Aliases: capability loss, cognitive atrophy
**The pessimistic case:** Cognitive atrophy accelerates.
Revised in: 005
Challenged in: 003, 005
Referenced in: 003
Related concepts: Dual Cognition Problem, Cognitive Preference Shift, Biological Ratchet
## Cognitive Preference Shift
Origin: 003
Status: active
Aliases: cognitive preference shift, preference shift
The paper needs to either find harder evidence or honestly downgrade the claim from "cognitive atrophy is happening" to "we observe a preference shift that *could* lead to atrophy if sustained, but we don't yet have evidence of actual capability loss."
Revised in: None
Challenged in: 005, 007
Referenced in: 005, 007, eves-apple, faust
Related concepts: Dual Cognition Problem, Cognitive Atrophy, Biological Ratchet
## Cognitive Surplus
Origin: 002
Status: active
Aliases: cognitive surplus, surplus of cognition, the cognitive surplus
If AI creates a comparable surplus of cognition — where not everyone needs to think through routine problems anymore — the downstream effects won't be "some jobs change." They'll be civilizational.
Revised in: 005
Challenged in: 004, 005, 006, 007, 008
Referenced in: 001, 003, 004, 006, 007, 008, faust
Related concepts: Agricultural Parallel, Cognition as a Commodity, Automation Spiral
## Collaboration Management
Origin: 001
Status: active
Aliases: collaboration management, recovery, task decomposition, trust calibration
- **Task decomposition** — breaking work into pieces that are the right size for AI collaboration.
Revised in: 004
Challenged in: 003
Referenced in: 002, 003
Related concepts: Social-Cognitive Framework, Adaptive Communication, Technical Foundation
## Continuity Argument
Origin: 008
Status: active
Aliases: continuity argument, the continuity argument
The human who discovered fire isn't the same species as the human who built the internet.
Revised in: None
Challenged in: None
Referenced in: None
Related concepts: Ship of Theseus Problem, Identity Argument, Pragmatic Argument
## Dependency Chain
Origin: 007
Status: active
Aliases: dependency chain
People went back to light switches — not because light switches are better technology, but because the *complexity of the dependency chain* became its own burden.
Revised in: None
Challenged in: 008, tower-of-babel
Referenced in: 008, eves-apple, faust, icarus, pandoras-box, prometheus, sorcerers-apprentice, the-golem, tower-of-babel
Related concepts: Biological Ratchet, Knowledge Unification, Cheating Frame
## Dependency Trap
Origin: 002
Status: active
Aliases: dependency trap, future 3: the dependency trap
Definition sentence not found in source text.
Revised in: 005
Challenged in: None
Referenced in: 003
Related concepts: Feudal Internet, Cognitive Atrophy, Y2K Parallel
## Dual Cognition Problem
Origin: 002
Status: active
Aliases: dual cognition problem, the dual cognition problem
Seth reported observing both effects simultaneously in himself:
Revised in: 005
Challenged in: None
Referenced in: None
Related concepts: Cognitive Preference Shift, Cognitive Atrophy, Cognitive Surplus
## Eve's Apple
Origin: eves-apple
Status: reference allegory
Aliases: eve's apple
Eve's Apple maps most directly to the **cognitive preference shift** described in Paper 005.
Revised in: None
Challenged in: None
Referenced in: 007, icarus, pandoras-box
Related concepts: Cognitive Preference Shift, Dependency Chain
## Existential Purpose of the Chain
Origin: 008
Status: active
Aliases: existential purpose, existential purpose of the dependency chain, the existential purpose of the dependency chain
If the dependency chain is a knowledge unification process, does it have a direction?
Revised in: None
Challenged in: None
Referenced in: None
Related concepts: Integration Layer, Cheating Frame, Knowledge Unification
## Faustian Bargain
Origin: faust
Status: reference allegory
Aliases: faust, faustian bargain
1592); Johann Wolfgang von Goethe, *Faust* (Part 1: 1808, Part 2: 1832) **Theme:** Trading something essential for knowledge and power — the bargain that seems rational at every step
Revised in: None
Challenged in: tower-of-babel
Referenced in: 007, 008, tower-of-babel
Related concepts: Feedback Loop, Cognitive Preference Shift
## Feedback Loop
Origin: 006
Status: active
Aliases: feedback loop
If the feedback loop closes — if AI learns to do vibe coding without vibe coders — then the skill framework is a description of a transitional state, not a permanent one.
Revised in: None
Challenged in: 007, 008
Referenced in: 005, 007, 008
Related concepts: Automation Spiral, Master-Apprentice Parallel, Niche Construction
## Feudal Internet
Origin: 002
Status: active
Aliases: feudal internet
Definition sentence not found in source text.
Revised in: 005
Challenged in: None
Referenced in: 003
Related concepts: Agricultural Parallel, Dependency Trap, Cognition as a Commodity
## Green Revolution
Origin: 002
Status: active
Aliases: green revolution
**Agricultural parallel:** The 20th-century Green Revolution, where agricultural technology was deliberately distributed to developing nations, dramatically reducing famine.
Revised in: 005
Challenged in: None
Referenced in: 003
Related concepts: Agricultural Parallel, Feudal Internet
## Icarus
Origin: icarus
Status: reference allegory
Aliases: icarus
Daedalus, the master craftsman, builds wings of feathers and wax for himself and his son Icarus to escape imprisonment on Crete.
Revised in: None
Challenged in: tower-of-babel
Referenced in: 007, tower-of-babel
Related concepts: Shelf-Life Problem, Infrastructure Threshold
## Identity Argument
Origin: 008
Status: active
Aliases: essentialist, identity argument, the identity argument
There's something essentially human — consciousness, subjective experience, mortality, biological embodiment, individual identity — and if you remove enough of those properties, the thing that remains isn't "us" regardless of continuity.
Revised in: None
Challenged in: None
Referenced in: None
Related concepts: Ship of Theseus Problem, Continuity Argument, Pragmatic Argument
## Information/Cognition Resource Hierarchy
Origin: 005
Status: active
Aliases: information and cognition as resources, resource hierarchy
Seth's hierarchy: "Information is the most valuable resource in the world.
Revised in: None
Challenged in: None
Referenced in: None
Related concepts: Cognition as a Commodity, Knowledge Unification
## Infrastructure Threshold
Origin: 007
Status: active
Aliases: infrastructure threshold
The question for AI: **has it already crossed the infrastructure threshold, or is it still in the application phase where the ebb-and-flow pattern could pull it back?** The honest answer is that AI is right now in the transition zone.
Revised in: None
Challenged in: 008
Referenced in: 008
Related concepts: Biological Ratchet, Premature Dependencies, Y2K Parallel
## Integration Layer
Origin: 008
Status: active
Aliases: integration layer
It's the **integration layer** that makes human cognition collectively useful for the first time in history.
Revised in: None
Challenged in: None
Referenced in: None
Related concepts: Knowledge Unification, Singularity as Compilation, Existential Purpose of the Chain
## Knowledge Unification
Origin: 008
Status: active
Aliases: knowledge unification, the dependency chain as knowledge unification, unification of human knowledge, unification thesis
The series has described the dependency chain — fire → language → writing → printing → internet → AI — as a sequence of increasing *capability.* Each link enables more than the one before.
Revised in: None
Challenged in: None
Referenced in: None
Related concepts: Dependency Chain, Singularity as Compilation, Integration Layer
## Master-Apprentice Parallel
Origin: 006
Status: active
Aliases: master-apprentice parallel, master-apprentice relationship
The closest historical parallel is the **master-apprentice relationship** — and it's worth taking seriously, not just as a passing comparison, because the places where it holds and breaks are revealing.
Revised in: None
Challenged in: None
Referenced in: None
Related concepts: Feedback Loop, Automation Spiral, The Golem
## Mental Model Accuracy
Origin: 001
Status: active
Aliases: mental model, mental model accuracy
The core competency is building and maintaining an accurate *mental model* of the AI as a collaborator — its capabilities, tendencies, failure modes, and dynamic personality.
Revised in: 004
Challenged in: 003
Referenced in: 003
Related concepts: Social-Cognitive Framework, Adaptive Communication, Collaboration Management
## Meta-Skill Argument
Origin: 004
Status: active
Aliases: meta-skill, meta-skill argument
The meta-skill of managing the overall collaboration:
Revised in: None
Challenged in: 006
Referenced in: 001, 003, 006, faust, icarus, pandoras-box
Related concepts: Shelf-Life Problem, Vibe Coding, Social-Cognitive Framework
## Neurodivergence Note
Origin: 001
Status: open question
Aliases: neurodivergence hypothesis, neurodivergence note
Definition sentence not found in source text.
Revised in: 004
Challenged in: 003
Referenced in: 003
Related concepts: Social-Cognitive Framework
## Niche Construction
Origin: 006
Status: active
Aliases: niche construction
There's a concept from evolutionary biology that captures what's happening better than any economic or historical analogy: **niche construction.**
Revised in: None
Challenged in: None
Referenced in: pandoras-box
Related concepts: Feedback Loop, Recursion Observation
## Pandora's Box
Origin: pandoras-box
Status: reference allegory
Aliases: pandora's box
Pandora's Box identifies a different irreversibility than Eve's Apple: **release, not knowledge.** The problem isn't that Pandora *knows* what's in the box — it's that the contents, once released, cannot be gathered back.
Revised in: None
Challenged in: None
Referenced in: 007
Related concepts: Dependency Chain, Automation Spiral
## Pragmatic Argument
Origin: 008
Status: active
Aliases: pragmatic argument, the pragmatic argument
The question "is it really us?" is a luxury of beings who currently have the option of surviving as-is.
Revised in: None
Challenged in: None
Referenced in: None
Related concepts: Ship of Theseus Problem, Continuity Argument, Identity Argument
## Premature Dependencies
Origin: 007
Status: active
Aliases: dependency waiting for its enabling technology, premature dependencies
And it's the most instructive example because it reveals the mechanism: **premature dependencies fail when the complexity cost exceeds the benefit before the technology becomes infrastructure.**
Revised in: None
Challenged in: None
Referenced in: None
Related concepts: Infrastructure Threshold, Biological Ratchet
## Prometheus
Origin: prometheus
Status: reference allegory
Aliases: prometheus
700 BCE); Aeschylus, *Prometheus Bound* (c.
Revised in: None
Challenged in: None
Referenced in: 007, 008, pandoras-box
Related concepts: Theological Thread, Dependency Chain, Cheating Frame
## Recursion Observation
Origin: 006
Status: open question
Aliases: cosmological → biological → linguistic → computational, recursion observation
**Is the recursion observation meaningful or just pattern-matching?** The cosmological → linguistic → computational recursion is aesthetically appealing.
Revised in: None
Challenged in: None
Referenced in: None
Related concepts: Theological Thread, Niche Construction, Knowledge Unification
## Shelf-Life Problem
Origin: 003
Status: active
Aliases: shelf life problem, shelf-life problem
thesis) and confront the shelf-life problem - Paper 002 needs to stress-test the agricultural analogy's limits, add the missing fourth future, and ground the cognitive atrophy argument in something harder than self-report - Both papers need to engage with the temporal problem: these aren't descriptions of a stable system, they're snapshots of a system in rapid transition
Revised in: None
Challenged in: 004
Referenced in: 004
Related concepts: Meta-Skill Argument, Infrastructure Threshold
## Ship of Theseus Problem
Origin: 008
Status: active
Aliases: identity problem, ship of theseus problem, species identity problem, the identity problem
If the dependency chain leads to a unified human-AI intelligence capable of surviving beyond Earth — is that still "us?"
Revised in: None
Challenged in: None
Referenced in: None
Related concepts: Continuity Argument, Identity Argument, Pragmatic Argument
## Singularity as Compilation
Origin: 008
Status: active
Aliases: compilation not transcendence, compilation, not transcendence, singularity as compilation
Definition sentence not found in source text.
Revised in: None
Challenged in: None
Referenced in: None
Related concepts: Knowledge Unification, Integration Layer, Cheating Frame
## Social-Cognitive Framework
Origin: 004
Status: active
Aliases: social-cognitive framework, social-cognitive processes, vibe coding as social skill
**What we propose:** Vibe coding involves significant social-cognitive processes — the same mental machinery used for modeling other minds — applied to AI collaboration.
Revised in: None
Challenged in: 002, 003, 005, 006
Referenced in: 001, 002, 003, 005, 006
Related concepts: Vibe Coding, Mental Model Accuracy, Adaptive Communication, Collaboration Management
## Sorcerer's Apprentice
Origin: sorcerers-apprentice
Status: reference allegory
Aliases: sorcerer's apprentice
The Sorcerer's Apprentice identifies the most specific and practical failure mode: **the gap between the ability to start an automated process and the ability to control it.**
Revised in: None
Challenged in: None
Referenced in: 007
Related concepts: Automation Spiral, Feedback Loop, Dependency Chain
## Technical Foundation
Origin: 001
Status: active
Aliases: technical expertise, technical foundation
Technical foundation helps enormously, but it's not the differentiator.
Revised in: 004
Challenged in: 003, 004
Referenced in: 003, 006
Related concepts: Vibe Coding, Collaboration Management, Meta-Skill Argument
## The Golem
Origin: the-golem
Status: reference allegory
Aliases: golem, the golem
**Source:** Jewish folklore, most prominently the Golem of Prague (Rabbi Judah Loew ben Bezalel, 16th century); earlier references in the Talmud and Sefer Yetzirah **Theme:** Creating a servant from raw materials that serves faithfully until it doesn't — and has no interiority to appeal to
Revised in: None
Challenged in: None
Referenced in: 007
Related concepts: Master-Apprentice Parallel, Dependency Chain
## Theological Thread
Origin: 006
Status: active
Aliases: theological thread
Definition sentence not found in source text.
Revised in: None
Challenged in: 008
Referenced in: 007, 008, prometheus
Related concepts: Prometheus, Knowledge Unification, Recursion Observation
## Tower of Babel
Origin: tower-of-babel
Status: reference allegory
Aliases: babel, tower of babel
Babel identifies a failure mode the other allegories miss: **the fragmentation of shared understanding as a consequence of — or response to — collective overreach.**
Revised in: None
Challenged in: None
Referenced in: 007
Related concepts: Dependency Chain, Knowledge Unification
## Vibe Coding
Origin: 001
Status: active
Aliases: vibe coding
The trigger for this paper: one of the authors (Seth) has been vibe coding since January 2026, building a homelab infrastructure with Claude Code across dozens of projects.
Revised in: 004
Challenged in: 002, 003, 004, 006, 007
Referenced in: 002, 003, 005, 006, 007, 008, faust, icarus, prometheus, sorcerers-apprentice, tower-of-babel
Related concepts: Social-Cognitive Framework, Mental Model Accuracy, Meta-Skill Argument
## Y2K Parallel
Origin: 005
Status: active
Aliases: ai y2k moment, y2k moment, y2k parallel
This revision does three things: stress-tests the agricultural analogy and draws its limits, adds a concrete economic mechanism (cognition as a commodity with a collapsing price), introduces the Y2K parallel for the dependency argument, and adds the missing fourth future.
Revised in: None
Challenged in: None
Referenced in: None
Related concepts: Dependency Trap, Infrastructure Threshold, Cognitive Surplus
File diff suppressed because it is too large Load Diff