Skip to content

Rewrite README as a narrative cyberpunk tactics introduction - #46

Open
scrimshawlife-ctrl wants to merge 2 commits into
mainfrom
agent/dynamic-readme-atlas
Open

Rewrite README as a narrative cyberpunk tactics introduction#46
scrimshawlife-ctrl wants to merge 2 commits into
mainfrom
agent/dynamic-readme-atlas

Conversation

@scrimshawlife-ctrl

@scrimshawlife-ctrl scrimshawlife-ctrl commented Jul 27, 2026

Copy link
Copy Markdown
Owner

What changed

  • Reframed the README around HexWire as a turn-based cyberpunk strategy tactics game rather than leading with repository architecture.
  • Added a narrative opening centered on a privatized surveillance city, contract work, small-team infiltration, tactical competence, and extraction under pressure.
  • Expanded the four-runner crew into clear battlefield identities: street samurai, mage, decker, and face.
  • Explained the Street / Signal / Trace / Lay Low loop in player-facing language while preserving the actual implemented mechanics.
  • Added a narrative run structure covering contracts, room-by-room combat, objectives, extraction, nuyen, faction attention, cyberware, and persistent consequences.
  • Grounded the campaign section in the repo’s six certified story missions, interstitial operations, seeded replay model, twenty arenas, side contracts, endless gauntlet, and New Game+.
  • Retained badges, the pressure-loop art, architecture diagram, build instructions, CI evidence, documentation links, and repository atlas below the narrative layer.

Narrative direction

The README now presents HexWire as a game about a capable but vulnerable crew operating inside a city-scale surveillance machine. Power is available through the Signal layer, but using it raises Trace and forces the player to trade tempo against survival. Combat is framed as objective-driven infiltration rather than simple enemy elimination: the job is not finished until a runner reaches extraction.

Source grounding

Claims were checked against:

  • docs/TraceSystem.md
  • docs/audit/MissionCertificationMatrix.md
  • plans.md
  • project.yml
  • .github/workflows/hexwire-ci.yml
  • the existing repository README and stabilization documentation

No unsupported lore, named corporations, mission plots, or unimplemented systems were presented as canonical.

Validation

Documentation-only change. Hosted CI remains the authoritative validation surface for project drift, tests, iPhone/iPad builds, hygiene, resources, and archive generation.

@scrimshawlife-ctrl scrimshawlife-ctrl changed the title Refresh README with dynamic project atlas Rewrite README as a narrative cyberpunk tactics introduction Jul 27, 2026
@scrimshawlife-ctrl
scrimshawlife-ctrl marked this pull request as ready for review July 27, 2026 05:26

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6d3e52cf39

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread README.md
Debug builds honor `SR_AUTOSTART_MISSION_ID`:

```bash
SR_AUTOSTART_MISSION_ID=Mission003

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Run the app in the autostart example

When this block is pasted into a shell, it only assigns a shell variable; it neither launches HexWire nor passes the value into a simulator process. Because HexwireApp.swift reads the app process environment, the documented “Launch directly” flow does nothing. Use the simulator-launch form, such as SIMCTL_CHILD_SR_AUTOSTART_MISSION_ID=Mission003 xcrun simctl launch <udid> com.hexwireaaron.game, instead.

AGENTS.md reference: AGENTS.md:L34-L35

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant