एक drifted primitive. प्रत्येक उत्पाद इस पर बनाया गया है

कोडिंग कभी भी इस पैमाने पर कठिन हिस्सा नहीं था

स्वामित्व, संदर्भ नहीं

संदर्भ गलत अक्ष है।

समस्या यह नहीं है "मैं कैसे एक एजेंट को अधिक संदर्भ देता हूँ

एक विंडो में ज्ञान लोड करें और यह विंडो के साथ मर जाता है।

तब एक सत्र प्रणाली को विस्तारित करने के लिए पैसे देता है।

स्टिलियोएजेंट मॉडल

StyloAgent उस संरचना को चलाने वाले प्रक्रियाओं में बदलता है

• ऑवरव्यू वास्तुकार और समन्वयक :overview-यह तीन जीवित दस्तावेजों को रखता है।
• विशेषज्ञ डोमेन मालिक foss- पहचान इंजन का स्वामित्व रखता है deploy- निर्माण का स्वामित्व करता है mae- सदस्यता और ई-commerce का स्वामित्व रखता है dash- और edit- डिस्प्लेस का स्वामित्व पढ़ने और लिखने के पथ prod- प्लेटफार्म सुरक्षा का स्वामित्व रखता है test- सूट का स्वामित्व रखता है
• संदेश बस : a git-backed, fileM SK3drop channel with inbox, outbox, archive, और saved-contextसंदेश एक एजेंट पर एक प्राथमिकता और सतह लेता है
• पुनर्जलीकरण और निर्जलीकरण प्रत्येक एजेंट एक जीवित संदर्भ दस्तावेज रखता है
• कार्यस्थान एक कार्यक्षेत्र के रूप में एफओएस रिपो और वाणिज्यिक रिपो रजिस्टर
• संचार एक सख्त नियम overview- मालिक से colliding के बजाय

यह वास्तव में क्या है

स्टिलियोएजेंट एक डेस्कटॉप कॉकपिट है। claude एक PTY के ऊपर चल रही प्रक्रिया, कॉकपिट में अपनी टर्मिनल के साथ, अपना जीटीई कार्यट्री, और अपने संदर्भ दस्तावेज़ के साथ-साथ\MSC3\ कॉकपीट एमसीपी सर्वर को होस्ट करता है एजेंट कॉल तथा अपनी स्थिति की रिपोर्ट करने वाले हुक सॉकेट जो उनकी स्थिति देता है।

flowchart TD
    operator([Human operator])
    subgraph SA["Styloagent cockpit"]
        cockpit[Cockpit Shell<br/>Avalonia + Dock]
        bus[Coordination and Fleet<br/>Channel, Mcp, Diagrams]
        session[Session and Terminal Runtime<br/>Sessions, Hooks, PTY]
        repo[Git and Document Library<br/>worktrees, Lucene search]
    end
    agents[Agent fleet<br/>claude specialists]
    fs[(Filesystem and Git<br/>durable trace + worktrees)]

    operator --> cockpit
    cockpit --> bus
    cockpit --> session
    cockpit --> repo
    bus --> session
    session -->|runs claude over a PTY| agents
    agents -->|MCP verbs| bus
    bus -->|reads and writes channel files| fs
    session -->|writes context doc on dehydrate| fs
    agents -->|commit in own worktree| fs

    style SA fill:none,stroke:#6b7280,stroke-width:1px
    style cockpit fill:none,stroke:#7c3aed,stroke-width:2px
    style bus fill:none,stroke:#d97706,stroke-width:2px
    style session fill:none,stroke:#2563eb,stroke-width:2px
    style repo fill:none,stroke:#16a34a,stroke-width:2px
    style agents fill:none,stroke:#6b7280,stroke-width:2px
    style fs fill:none,stroke:#16a34a,stroke-width:3px
    style operator fill:none,stroke:#6b7280,stroke-width:2px

सीपीसी कोर है cockpit hosts a MCP server, and everything a specialist does to coordinate is an MCP tool call against it

• send_message / check_inbox : रूट कार्य और इसे खींचने के लिए।
• spawn_agent एक मालिक ने इसके तहत एक नया विशेषज्ञ को विभाजित कर दिया
• claim / heartbeat / release एक साझा परिवेश में अभिगम को क्रमबद्ध करें
• dehydrate_agent / rehydrate_agent एक विशेषज्ञ पार्क करें और इसे पुनर्स्थापित करें
• wrap_up परीक्षण:,Merge,Clean up a finished branch
• report_issue, architecture_impact, agent_color, list_fleet एक ब्लॉकर फाइल करें

फ़ाइल के नीचे ड्रॉप चैनल जो कहा गया था उसका स्थायी ट्रेस है।

कैसे बस वास्तव में प्रदान करता है

send_message चैनल में एक स्थायी मार्कडाउन फ़ाइल लिखता है और भी प्रदान करता है ChannelDeliveryCoordinator नए फ़ाइलों के लिए देखता है

एक संदेश को कितना कठिन विराम करता है एक मुक्त नहीं है DeliveryMode एक विच्छेदन सीढ़ी :

public enum DeliveryMode
{
    Interrupt,       // send ESC to break the current turn, inject immediately
    NextPrompt,      // queue; inject when the agent next reaches idle
    Poll,            // not pushed; the agent checks on its own cadence
    Convenient,      // surfaced in the Bus HUD only
    Informational,   // never actioned or injected; shown as info
}

वितरण निष्क्रिय है।

स्वामित्व कैसे लागू किया जाता है

आपके लाइन में रहना एक सम्मान प्रणाली नहीं है ownership.yaml, और एक OwnershipMap किसी भी रिपो को हल करता है-उस अभिकर्ता उपसर्ग के लिए सम्बन्धित पथ जो इसका स्वामित्व रखता है

// most-specific glob wins, so a session- carve-out inside cockpit-'s
// src/Styloagent.App/** beats the broad glob
public string? OwnerOf(string? path) { /* ... */ }

एक PreToolUse गेट उस हलकर्ता को खपत करता है और एक एजेंट को एक फ़ाइल लिखने से रोकता है जो अन्य एजेंट के स्वामित्व में है overview- सीमाओं को पार कर सकते हैं क्योंकि यह मध्यस्थता करता है

जीवितdocs लूप

overview- स्वतंत्र नहीं करता है. इसकी प्रणाली प्रवर्धन इसे रील पर रखता है : काम ऊपर से नीचे के तीन स्तरों मेंM SK3 और आगे न जाएँ

flowchart LR
    spec["spec.md<br/>what the system is"]
    shape["architecture.md<br/>C4 shape, owner-coloured"]
    fleet["proposed-agents.yaml<br/>who owns each component"]
    spec --> shape --> fleet
    fleet -.->|specialists report on the bus| spec

    style spec fill:none,stroke:#2563eb,stroke-width:2px
    style shape fill:none,stroke:#d97706,stroke-width:2px
    style fleet fill:none,stroke:#16a34a,stroke-width:2px

पहले विनिर्दिष्ट करें : तंत्र क्या है, अन्य किसी भी वस्तु से पहले मानव के साथ सहमत हो गया। overview- अपने निष्कर्षों को वापस स्पेक्ट में फोल्ड करता है।

कार्यों के बजाय विशेषज्ञ

अधिकतर एजेंट उपकरणों से कर्मचारी पैदा होते हैं।

स्टिलियोएजेंट विशेषज्ञ बनाता है foss- एक बार पता लगाने की इंजन को छुने वाला कोई कर्मचारी नहीं है।

पहचाने गए बॉट्स dashboard पर दिखाए जा रहे थे जो बहुत उच्च जोखिम के रूप में प्राप्त किया गया था। foss- ऐसा नहीं किया था क्योंकि foss- यह पता चला कि जोखिम पट्टी सिर्फ दोस्ती के लिए pins है जब एक अंगुल छाप एक सत्यापित दावे स्थिति के साथ भंडारित किया जाता है और कि उस स्थिति को सेट करने वाली विधि UpdateClaimVerificationAsync, था उत्पादन में शून्य कॉलरलिखा गया और कभी भी तार नहीं किया गया

यह निदान इकमुश्त स्वामित्व से आया था foss- पहले से ही वादक को मानचित्रित कर चुका था

StyloAgent यह अपने आप पर साबित करता है cockpit- Avalonia शेल के स्वामित्व में है bus- समन्वय और वितरण के स्वामित्व में है session- पीटीआई और स्पाउन स्टेट मशीन के स्वामित्व में है repo- जीट और दस्तावेज़ लाइब्रेरी का स्वामित्व रखता है। session-अपना संदर्भ दस्तावेज़

## HARD-WON DISCIPLINE (enforced this session, confirmed by overview-)
- Commit by explicit pathspec, atomically, in ONE command. The shared tree has ONE git
  index. A bare `git commit` after `git add` lets ANOTHER agent's concurrent commit sweep
  your staged files (it happened: my clipboard work landed mis-attributed in cockpit-'s 5e54207).

एक कार्य पर आधारित कर्मचारी उस collision को टकराता है, और अगला कर्मचारी इसे फिर से टकराव करता है, क्योंकि कोई भी पाठ आगे नहीं लेता session- इसे एक बार Hit it once, understand why, and encoded the fix as part of who it is

पुनः खोज के बजाय पुनर्जलीकरण

एक ठंडा सत्र एक रीति से आरंभ होता है।

पुनर्जलीकरण रीति-रिवाज को हटाता है।

राज्य प्रति विशेषज्ञ के एक फ़ाइल में रहता है. यह वास्तविक सहेजा गया संदर्भ है foss-हल्का टर्म किया गया

# foss- saved context

## Repo state
- Branch: main. My fix commit: 9b849629 (NOT pushed) - the known-bots-VeryHigh fix.

## DONE this session
- known-bots-VeryHigh fix (9b849629) - overview APPROVED, shipped:
  ROOT: UpdateClaimVerificationAsync had ZERO prod callers (never wired). Every fp
  stayed 'unverified' -> known bots read VeryHigh. Redeploying #115 could never fix it.

## NEXT (open, in priority order)
1. overview follow-up: add a REAL end-to-end test through the REAL store, not a double.
2. RISK display Face 1 (still OPEN): risk band missing from dashboard LIST rows.

## Guardrails
- ANY prod fingerprint-DB op = staging-first + express human go.
- CF-IP caveat: if the gateway verifies the bot against CF egress not the real client IP,
  the latch never sets -> still VeryHigh.

एक ताजा foss- यह पढ़ता है और तुरंत मौजूदा है।

एक एजेंट सत्र चार अवस्थाओं के माध्यम से चलता है Unspawned, Live, Dehydrated, Exited.

flowchart LR
    Unspawned[Unspawned] -->|spawn: PTY + launch prompt| Live[Live]
    Live -->|write context doc, stop PTY| Dehydrated[Dehydrated]
    Dehydrated -->|rehydrate: restore from context| Live
    Live -->|wrap up: test, merge, cleanup| Exited[Exited]

    style Unspawned fill:none,stroke:#6b7280,stroke-width:2px
    style Live fill:none,stroke:#16a34a,stroke-width:2px
    style Dehydrated fill:none,stroke:#d97706,stroke-width:2px
    style Exited fill:none,stroke:#6b7280,stroke-width:2px

डिहाइड्रेटिंग संदर्भ दस्तावेज लिखता है और पीटीआई को जारी करता है।

मौजूदा प्रणालियों को समझना

फ्लाइट को किसी ऐसी प्रणाली पर छोड़ दें जिसे उसने कभी नहीं देखा है।

overview- खोज करने के लिए चला गया। यह पठनीय चलाया। < s> केवल खोज एफओएस कोर से गुजरता है और वास्तविक पाइपलाइन का पता लगा।

From: overview-   Priority: urgent
# PRIORITY: the RISK display+correctness on the dashboard (human: this is the WORST)
Known bots showing VeryHigh ... known-good bots should latch friendly/Verified.
Report root cause + fix.

From: overview-   Priority: normal
# APPROVED - ship it (TDD). No DB op = perfect; add a REAL test of the wired flow
1. ADD A REAL TEST that exercises the ACTUAL wired flow end-to-end ... NOT one that
   manually calls UpdateClaimVerificationAsync. That's the exact false-confidence gap
   that hid this.
2. The CF / real-client-IP caveat is real ... if the gateway sees CF egress, the latch
   never fires.

From: overview-   Priority: low
# 883a1277 real E2E test = exactly right; told deploy- to build it.
... drives the actual orchestrator + real store + real projection, no manual call ...
that fully closes the false-confidence gap that hid this.

sequenceDiagram
    participant H as Human
    participant O as overview-
    participant F as foss-
    participant D as deploy-
    H->>O: the risk display is the WORST
    O->>F: PRIORITY (urgent), root-cause the risk verdict
    F->>F: trace projection to the claim latch
    F->>O: root cause, UpdateClaimVerificationAsync never wired
    O->>F: APPROVED, ship it plus a REAL end-to-end test
    F->>F: commit 9b849629, then 883a1277 (real e2e test)
    O->>D: rebuild the gateway from 883a1277
    D->>D: staging, known bot now reads LOW not VeryHigh
    D->>O: verified green on staging, ready for a guarded prod cut