From 3579884cea062f472cfa207dd2f0db7cbc7a24f1 Mon Sep 17 00:00:00 2001 From: Meta Vens Date: Sat, 18 Apr 2026 15:57:19 +0100 Subject: [PATCH] Updated Readme --- AGENTS.md | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 48 ++++++++++++++++++++++++++++++++++++++++++- 2 files changed, 108 insertions(+), 1 deletion(-) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..8b9e2b4 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,61 @@ +# AGENTS.md + +## Purpose + +This repository is an Obsidian vault for the Aetheria setting. Contributions should preserve it as a coherent worldbuilding knowledge base rather than treating it like generic prose storage. + +## Project Conventions + +- Prefer Markdown notes organized by setting domain, era, faction, technology, concept, species, or timeline event. +- Keep files in the existing folder hierarchy unless there is a strong structural reason to introduce a new branch. +- Name notes in Title Case, usually matching the in-universe proper noun or concept exactly. +- Preserve Obsidian-style wiki links such as `[[Aether]]`, `[[Timeline]]`, and `[[Pan-Solar Consortium]]`. +- Favor creating or strengthening links between notes over repeating the same explanation in multiple places. +- Avoid YAML frontmatter unless the repository begins using it consistently in the future. + +## Writing Style + +- Write in clear, polished Markdown prose. +- Default to a serious, analytical, high-concept science-fantasy / science-fiction voice. +- Treat the setting as materially grounded: economics, ideology, infrastructure, labor, warfare, governance, class power, and technological constraints should feel causally connected. +- Keep speculative elements legible by anchoring them in social, political, or physical consequences. +- Use vivid phrasing when appropriate, but avoid empty flourish that does not add setting information, mood, or ideological texture. +- Maintain internal consistency with existing terminology, institutions, factions, and timeline beats. + +## Tone + +- The project's dominant tone is sober, reflective, and politically aware. +- Many notes frame technology and institutions in terms of incentives, domination, exploitation, regulation, resistance, and material tradeoffs. Preserve that lens. +- When expanding factions or concepts, avoid flattening them into pure heroes, villains, or aesthetic stereotypes. Emphasize tensions, contradictions, and historical pressures. +- Keep the writing attentive to how systems shape lived experience, not just to spectacle or lore trivia. + +## Note Structure + +- Match the local structure of neighboring notes before introducing a new pattern. +- Many notes begin with a short orienting paragraph, while others begin with a heading such as `### `. Either is acceptable if used intentionally. +- Use short thematic sections with Markdown headings when a note benefits from subdivision. +- Timeline and index notes should stay scannable, with compact summaries and linked entries. +- Faction, technology, and concept notes should explain what the subject is, how it functions, who it affects, and why it matters in the broader setting. +- Prefer concise paragraphs over oversized blocks when clarity would benefit. + +## Content Expectations + +- New material should deepen the setting rather than merely decorate it. +- Ask of each addition: what pressures produced this, who benefits, who is constrained, what contradictions does it create, and how does it interact with other parts of the setting? +- Be mindful of continuity across Pre-Elysium, Post-Elysium, politics, technology, and factional history. +- When possible, connect abstract concepts to institutions, everyday life, and conflict. + +## Cultural And Historical Guidance + +- Always be mindful of the societal and cultural impact of technology. +- Always be mindful of the historical dialectic: institutions, ideologies, and technologies should be understood as emerging from conflict, material conditions, and changing power relations. +- Treat technological change as socially embedded, not neutral or autonomous. +- Consider how class, labor, governance, identity, colonial dynamics, media, and infrastructure mediate the effects of any technology or social system added to the setting. +- Prefer writing that reveals contradiction, contingency, and historical development over writing that treats the world as static. + +## Editing Guidance For Future Agents + +- Read adjacent notes before making substantial additions so new material matches local vocabulary and structure. +- Preserve existing links and add new ones where they genuinely improve navigation. +- Do not remove ambiguity or tension unless the note is clearly meant to resolve a question. +- If you encounter malformed characters from prior encoding issues, fix them carefully and only where you can do so confidently without changing meaning. diff --git a/README.md b/README.md index 7c821ba..2ec5169 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,48 @@ # AetheriaLore -Obsidian Vault containing Aetheria worldbuilding work + +AetheriaLore is an Obsidian vault for the Aetheria setting: a politically charged science-fantasy / science-fiction world shaped by corporate power, technological escalation, ideological struggle, and the long consequences of social collapse. + +At its core, Aetheria imagines a world where capitalism has been pushed to its farthest conclusion. Identity, labor, infrastructure, warfare, media, and even consciousness itself are mediated by profit, governance, and competing systems of control. The repository collects the notes that define that setting and trace how its factions, technologies, concepts, and histories fit together. + +## What This Repository Contains + +The vault is primarily organized under `Aetheria/Worldbuilding/`, with major sections for: + +- `Pre-Elysium`: the history, factions, technologies, movements, and timeline of the solar-system era before the setting's major rupture. +- `Post-Elysium`: the concepts, species, and technologies that define the transformed setting after that rupture. +- `Politics`: the legal, strategic, and institutional logic that governs conflict and power. + +## How To Read It + +This project works best as a connected knowledge base rather than a linear manuscript. + +- Start with `Aetheria/Introduction.md` for the broad premise. +- Move into `Aetheria/Worldbuilding/Pre-Elysium/Timeline.md` for the macro-historical arc. +- Follow wiki links such as `[[Megas]]`, `[[Aether]]`, or `[[Pan-Solar Consortium]]` to move between related ideas. +- Browse by subject if you prefer: factions, movements, technologies, concepts, and political structures are all broken out into separate notes. + +If you open the vault in Obsidian, the internal wiki links will give the best reading experience. + +## What Makes Aetheria Distinct + +Aetheria is not just a catalog of cool technologies or factions. The setting is built around cause and effect: + +- technology is treated as socially embedded rather than neutral, +- institutions emerge from material pressures and historical conflict, +- faction identity is shaped by class power, ideology, labor relations, and survival strategies, +- worldbuilding is grounded in incentives, contradictions, and lived consequences. + +That means the repository is especially focused on questions like: + +- Who benefits from a given technology? +- Who is constrained, exploited, or erased by it? +- What forms of resistance, adaptation, or control does it produce? +- How do political economy and historical struggle shape the world over time? + +## For Contributors + +This repository now includes project guidance in `AGENTS.md`, which documents the conventions, tone, structure, and thematic expectations used across the vault. If you plan to expand or revise the setting, start there before making broad changes. + +## License + +See `LICENSE` for repository licensing details.