Skip to content

Commit 37129cb

Browse files
docs: acknowledge Pane-A in core docs and rule files (#21)
* docs: acknowledge Pane-A in core docs and rule files (#20) src/View.res renders four panes (Pane-A, Pane-L, Pane-N, Pane-W) and the README table at lines 99-110 enumerates all four, but several adjacent docs and rule files still framed the layout as three panes (no Pane-A). This commit reconciles the most direct "three panel(s)/pane(s)" claims with the implementation. Touched: - README.adoc: section heading "Three-Pane Parallel Layout" -> "Four-Pane Parallel Layout" (the table immediately below it already lists four). - .claude/CLAUDE.md: "106 panels across three panes ..." -> four panes, with Panel-A added and a one-line note on the Binary Star core (L + N orbiting W) plus Panel-A's ambient role. - .machine_readable/6a2/META.a2ml: Binary Star decision now enumerates four panels (three orbital + one ambient); the three-pane-layout key is renamed four-pane-layout, with position called out as design intuition rather than architectural fact (architectural relationship is by flow + viewing perspective). - .machine_readable/6a2/ECOSYSTEM.a2ml: VeriSimDB mapping reframed as a mapping to the L/N/W panes of PanLL's four-pane layout (with Panel-A as ambient substrate, not part of the VCL-DT mapping). - Six rule files (.cursorrules, .clinerules, .github/copilot-instructions.md, .junie/guidelines.md, .q/rules/coordination.md, .claude/CLAUDE.generated.md): binary-star "Decision: Three panel types ..." -> "Four panel types" with Panel-A added; the Why line now distinguishes the Binary Star orbital core (L + N around W) from Panel-A's ambient role. Out of scope for this PR (Binary Star descriptions left intact): - Lines 101 and 196 in the rule files are descriptions of the Binary Star architecture, which is genuinely a three-pane metaphor (L + N orbiting W). They are correct as written. - Line 103 ("The three panel types serve fundamentally different roles") and line 186 ("Binary Star model has exactly three types") are also Binary Star claims; they are accurate when read as referring to Binary Star types specifically. Reframing them so they remain accurate in the presence of Panel-A requires more nuance than this PR aims to land — left for a follow-up. - README.adoc:287 (v0.2.0 component enumeration) is a snapshot of v0.2.0 status; PaneA may not have been functional at that release, so left unmodified. Refs: #20 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * docs(help): acknowledge Pane-A in user-visible help content (#20) HelpContent.res had two stale entries that surfaced "three-panel" framing to operators in the Help panel: - "welcome" entry body (line 44): "...unified three-panel workspace" -> "...unified four-panel workspace (Panel-A ambient substrate, Panel-L logic/symbolic, Panel-N neural, Panel-W world/barycentre)". - "three-panel-layout" entry (lines 56-64): renamed id and title to four-panel-layout, body rewritten to introduce Panel-A as ambient substrate, Panel-L's letter clarified as "Logic" rather than "left", and the "(left)/(centre)/(right)" position framing replaced with flow-and-perspective framing per the architectural model. - Keywords on the layout entry extended: keep "three-panel" for backward search, add "four-panel", "panel-a", "ambient", "binary star". The "three-panel-layout" id is referenced in only this file — no inbound help-anchor links break. Refs: #20 --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 6ae4336 commit 37129cb

11 files changed

Lines changed: 30 additions & 25 deletions

File tree

‎.claude/CLAUDE.generated.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -158,9 +158,9 @@ These choices may look unusual but are intentional:
158158

159159
### binary-star
160160

161-
**Decision:** Three panel types: Panel-L (symbolic/human), Panel-N (neural/machine), Panel-W (world/shared)
161+
**Decision:** Four panel types: Panel-A (ambient/substrate), Panel-L (logic/symbolic), Panel-N (neural/machine), Panel-W (world/shared)
162162

163-
**Why:** Neurosymbolic architecture requires clear separation of human reasoning, machine inference, and shared world state
163+
**Why:** L + N orbit W in the Binary Star core (clear separation of human reasoning, machine inference, and shared world state); Panel-A surrounds as ambient substrate for persistent context and ergonomic support.
164164

165165
### vexometer-cognitive-load
166166

‎.claude/CLAUDE.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ deno task test:coverage
4848
- **TEA (The Elm Architecture)** in ReScript — Model/Msg/Update/View/Subscriptions
4949
- **Gossamer** (Zig + WebKitGTK) backend — migrated from Tauri 2.0
5050
- **Elixir/BEAM** optional middleware (`beam/panll_beam`)
51-
- **106 panels** across three panes: Panel-L (Symbolic), Panel-N (Neural), Panel-W (World)
51+
- **106 panels** across four panes: Panel-A (Ambient), Panel-L (Logic, role: Symbolic), Panel-N (Neural), Panel-W (World). Panel-L + Panel-N orbit Panel-W in the Binary Star core; Panel-A surrounds as ambient substrate.
5252

5353
## Key Files
5454

‎.clinerules‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -158,9 +158,9 @@ These choices may look unusual but are intentional:
158158

159159
### binary-star
160160

161-
**Decision:** Three panel types: Panel-L (symbolic/human), Panel-N (neural/machine), Panel-W (world/shared)
161+
**Decision:** Four panel types: Panel-A (ambient/substrate), Panel-L (logic/symbolic), Panel-N (neural/machine), Panel-W (world/shared)
162162

163-
**Why:** Neurosymbolic architecture requires clear separation of human reasoning, machine inference, and shared world state
163+
**Why:** L + N orbit W in the Binary Star core (clear separation of human reasoning, machine inference, and shared world state); Panel-A surrounds as ambient substrate for persistent context and ergonomic support.
164164

165165
### vexometer-cognitive-load
166166

‎.cursorrules‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -158,9 +158,9 @@ These choices may look unusual but are intentional:
158158

159159
### binary-star
160160

161-
**Decision:** Three panel types: Panel-L (symbolic/human), Panel-N (neural/machine), Panel-W (world/shared)
161+
**Decision:** Four panel types: Panel-A (ambient/substrate), Panel-L (logic/symbolic), Panel-N (neural/machine), Panel-W (world/shared)
162162

163-
**Why:** Neurosymbolic architecture requires clear separation of human reasoning, machine inference, and shared world state
163+
**Why:** L + N orbit W in the Binary Star core (clear separation of human reasoning, machine inference, and shared world state); Panel-A surrounds as ambient substrate for persistent context and ergonomic support.
164164

165165
### vexometer-cognitive-load
166166

‎.github/copilot-instructions.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -158,9 +158,9 @@ These choices may look unusual but are intentional:
158158

159159
### binary-star
160160

161-
**Decision:** Three panel types: Panel-L (symbolic/human), Panel-N (neural/machine), Panel-W (world/shared)
161+
**Decision:** Four panel types: Panel-A (ambient/substrate), Panel-L (logic/symbolic), Panel-N (neural/machine), Panel-W (world/shared)
162162

163-
**Why:** Neurosymbolic architecture requires clear separation of human reasoning, machine inference, and shared world state
163+
**Why:** L + N orbit W in the Binary Star core (clear separation of human reasoning, machine inference, and shared world state); Panel-A surrounds as ambient substrate for persistent context and ergonomic support.
164164

165165
### vexometer-cognitive-load
166166

‎.junie/guidelines.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -158,9 +158,9 @@ These choices may look unusual but are intentional:
158158

159159
### binary-star
160160

161-
**Decision:** Three panel types: Panel-L (symbolic/human), Panel-N (neural/machine), Panel-W (world/shared)
161+
**Decision:** Four panel types: Panel-A (ambient/substrate), Panel-L (logic/symbolic), Panel-N (neural/machine), Panel-W (world/shared)
162162

163-
**Why:** Neurosymbolic architecture requires clear separation of human reasoning, machine inference, and shared world state
163+
**Why:** L + N orbit W in the Binary Star core (clear separation of human reasoning, machine inference, and shared world state); Panel-A surrounds as ambient substrate for persistent context and ergonomic support.
164164

165165
### vexometer-cognitive-load
166166

‎.machine_readable/6a2/ECOSYSTEM.a2ml‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -73,8 +73,9 @@ notes = "Fleet panel wired with 6 bots and safety triangle. BoJ agent-mcp routes
7373

7474
[related-projects.verisimdb]
7575
relationship = "primary-backend-module"
76-
nature = """VeriSimDB is PanLL's first database backend. VCL-DT maps to three-panel layout:
77-
Panel-L = proof obligations, Panel-N = agentic inference, Panel-W = query results."""
76+
nature = """VeriSimDB is PanLL's first database backend. VCL-DT maps to the L/N/W panes
77+
of PanLL's four-pane layout: Panel-L = proof obligations, Panel-N = agentic inference,
78+
Panel-W = query results. (Panel-A is ambient substrate and is not part of this mapping.)"""
7879
integration-status = "active"
7980
notes = "BoJ database-mcp cartridge routes VCL queries when bojRouting=true."
8081

‎.machine_readable/6a2/META.a2ml‎

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,9 @@ context = """Traditional IDEs treat AI as tool or assistant (Human-as-primary, M
2121
Need architecture that enables genuine co-working without subordination."""
2222
decision = """Model Human and Machine as Binary Star system — two gravitationally bound entities
2323
orbiting a shared Barycentre (the task/artifact). Neither is primary.
24-
Three panels: Panel-L (Symbolic/Human), Panel-N (Neural/Machine), Panel-W (World/Barycentre)."""
24+
Four panels (three orbital + one ambient): Panel-L (Symbolic/Human), Panel-N (Neural/Machine),
25+
Panel-W (World/Barycentre), Panel-A (Ambient substrate). The L + N orbiting W relationship is
26+
the Binary Star core; Panel-A surrounds as ambient substrate for persistent context."""
2527
consequences-positive = [
2628
"Enables sustained co-working without constant context switching",
2729
"Operator can see Machine reasoning stream in real-time (Panel-N)",
@@ -105,8 +107,10 @@ license-policy = "All original code PMPL-1.0-or-later. Third-party dependencies
105107
# --- Design Rationale ---
106108

107109
[design-rationale]
108-
three-pane-layout = """Parallel layout (L/N/W side-by-side) emphasises simultaneity.
109-
Panel-L (left) = Symbolic, Panel-N (middle) = Neural, Panel-W (right) = World.
110+
four-pane-layout = """Parallel layout (A/L/N/W) emphasises simultaneity.
111+
Panel-A = Ambient substrate, Panel-L = Logic (role: Symbolic), Panel-N = Neural,
112+
Panel-W = World/Barycentre. Position is design intuition (L on the left, W central)
113+
not architectural; the architectural relationship is by flow + viewing perspective.
110114
Layout inspired by music production DAWs (multiple simultaneous views)."""
111115
binary-star-metaphor = """Metaphor from astrophysics: two stars orbiting shared centre of mass.
112116
Human = symbolic star, Machine = neural star. Barycentre = task/artifact.

‎.q/rules/coordination.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -158,9 +158,9 @@ These choices may look unusual but are intentional:
158158

159159
### binary-star
160160

161-
**Decision:** Three panel types: Panel-L (symbolic/human), Panel-N (neural/machine), Panel-W (world/shared)
161+
**Decision:** Four panel types: Panel-A (ambient/substrate), Panel-L (logic/symbolic), Panel-N (neural/machine), Panel-W (world/shared)
162162

163-
**Why:** Neurosymbolic architecture requires clear separation of human reasoning, machine inference, and shared world state
163+
**Why:** L + N orbit W in the Binary Star core (clear separation of human reasoning, machine inference, and shared world state); Panel-A surrounds as ambient substrate for persistent context and ergonomic support.
164164

165165
### vexometer-cognitive-load
166166

‎README.adoc‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -89,7 +89,7 @@ It is:
8989

9090
== Architecture
9191

92-
=== The Three-Pane Parallel Layout
92+
=== The Four-Pane Parallel Layout
9393

9494
[cols="1,3"]
9595

0 commit comments

Comments
 (0)