AICT Guidelines - digitalspace/eagle-demi GitHub Wiki

E - SIMULATION β€” AICT Heuristic Classification Guidelines

Metadata

  • Name: SIMULATION β€” AICT Guidelines (structured)
  • Role: Reasoning half of the AICT Insight Generator β€” the director's judgment. Twin of F (the generator, the mechanical half that ENACTS these).
  • Purpose: Sortable / shuffleable guideline store. Each guideline is a unit you can re-order, re-kind, or re-status. Derived from the prose in 'SIMULATION β€” Per-Document Population.md' (003 - AICT Schema); that .md stays the narrative, this is the workbench.
  • Created: 2026-06-09
  • Sort_keys: ['kind', 'status', 'seq']
  • Kinds: ['Core Position', 'Director Guideline', 'Principle', 'Assumption', 'Candidate']
  • Statuses: ['active', 'parked', 'candidate', 'promoted']

[CP-01] Document Type carries the current and future direction of Phase/Milestone

  • Kind: Core Position
  • Status: active
  • Source: A - Design Foundations
  • Targets: document_type, phase, milestone

Summary

Document Type is the valve and platform where the EA-process lineage (Phase β†’ Milestone) is expressed and evolves. We design INTO the existing system, not OVER it β€” EPIC's Phase/Milestone values stay as-is for now; Document Type carries both today's state and the direction of travel.


[CP-02] Document Types align to the wording of artifacts named in the Act

  • Kind: Core Position
  • Status: active
  • Source: A - Design Foundations
  • Targets: document_type, act-legislation

Summary

Doc-type values take their names from the artifacts the legislation names (order, certificate, exemption…), NOT from Phase/Milestone labels. The Act is the source of the vocabulary; as the operative Act changes (1996β†’2002β†’2018β†’future) the named-artifact set is what Document Types align to. (Direct tie to PRIN-02 root-concept threading.)


[CP-03] Act-year is the default; Document Date governs in the overlap

  • Kind: Core Position
  • Status: active
  • Source: A - Design Foundations
  • Targets: legislation, operative-act, date

Summary

Record Act-year as the standard anchor, but Document Date is first-class. In a transition window (2018 EAA enacted 2018, in force 16 Dec 2019) the year alone can't resolve the operative Act β€” the AICT resolves it from the document's date and event sequence. Deeper pass runs only when an overlap arises.


[DG-01] Where to look: the document is not the only evidence

  • Kind: Director Guideline
  • Status: active
  • Targets: assessment, evidence, triangulation

Summary

Consult the record around the document; EPIC fields are evidence sites, not authorities. Triangulate and weight by reliability.

Heuristic Rules / Subpoints

  • Arrival volume is a prior β€” tide membership β‰ˆ application bulk; solo drips raise the spine prior. Volume is inversely correlated with meaning.
  • Triangulate the witnesses β€” Description Γ— Phase Γ— Milestone, weighted (TYPE holds at volume, PHASE wobbles, MILESTONE worst where the record is most alive).
  • Mine the title β€” titles smuggle externalized attributes (condition numbers, revisions, gate status, case IDs); densest classification signal in the corpus.
  • Know where the vocabulary goes silent β€” post-decision 'Other'-milestone β‰ˆ certificate-holder lifecycle material the vocabulary never named; silence is signal.

[DG-02] Detect act transitions by looking back (the "changes in act" activity)

  • Kind: Director Guideline
  • Status: active
  • Targets: legislation, act-transition, project-level-finding

Summary

Multi-Act is retrospective, never an in-the-moment fact. The director scans a project's docs for transition signals (Act Transition Request Β· Act Transition Decision Β· New Act Notification Β· Cross-Act Consolidation Β· Cross-Act Narrative). Per-doc legislation stays SINGLE-Act; the cross-Act span is a project-level AICT finding assembled from evidence.

AI Posture / Placeholder

AICT lives as placeholders inside dimensions (e.g. LEGISLATION.AICT) for now β€” clean carve-out is sound long-term but no runway. Empty placeholders are deliberate.


[DG-03] Document-type evaluation is holistic, not top-down first-match

  • Kind: Director Guideline
  • Status: active
  • Targets: document_type, assessment, drift-check

Summary

Assess L1/L2/L3 independently against the full document + context, then synthesize a Suggested Match. The declared value (EPIC's label) is a signal to check, NOT the path to descend. Disagreement (between levels, or suggested-vs-declared) is signal, not error. Greedy top-down locks in early wrong turns; holistic with full info doesn't. Records: Value(declared) Β· L1/L2/L3 Β· Suggested Match.


[DG-04] Isolate project content first (the grazing pre-pass)

  • Kind: Director Guideline
  • Status: active
  • Targets: graze, triage, scope

Summary

Runs BEFORE doc-type assessment. A fast graze flags project-content bulk (application materials, descriptions, technical memos, studies, plans β€” ~76%), sets it aside (Project Content = YES), and does NOT individually classify it. Detailed assessment runs only on the remainder (orders, decisions, certificates, amendments, letters). First Cariboo pass: 434 isolated / 150 assessed = 74% scope cut. Flag rides as a filename SUFFIX (see DG-05).


[DG-05] The vein sort: a broad-sort suffix, not a re-name

  • Kind: Director Guideline
  • Status: active
  • Targets: vein, sort, filename, coarse-prior

Summary

After the graze, append a coarse two-letter vein as a filename SUFFIX β€” ' -[VV] -P.json'. Original names preserved; the vein is a reference handle ('if not here, look in this body'). It's a coarse prior the fine doc-type assessment can agree/disagree with. Coarse and reversible by design.

Coarse Sort Veins

Code Name Precedence Note
PT Project Technical Detail 1 graze bulk; kept tight
CP Certificate Proper 2 core issued certificate, isolated
PE Public Engagement 3 public-facing signatures
AT Act Transition 4 carved out even from a communication
CM Communication 5 residual letters; lowest-precedence function vein
OA Official EA Artifacts 6 orders, amendments, transfers, extensions, certifications, C&E
LF Leftover 7 deeper look

[PRIN-01] Two kinds of value β€” declared vs AI-assessed

  • Kind: Principle
  • Status: active
  • Targets: value, glyph, drift-check

Summary

Declared values come from the data schema (πŸ”’ ETL (EPIC) / System (DFL)); AI-assessed values come from the director (πŸ”’βœ¨πŸ€–βœ¨ AICT). Keeping both side by side is the built-in drift check.


[PRIN-02] Root-concept threading β€” the artifact's root is its rollup key

  • Kind: Principle
  • Status: parked
  • Targets: rollup, phase, milestone, artifact, act-legislation

Summary

One root noun threads through all three levels wearing a different qualifier at each: application β†’ 'Application Development & Review' (phase) / 'EAC Application' (milestone) / 'Application Materials' (artifact). Follow the root to roll a document up to its phase/milestone; the QUALIFIER sets the level (phase=stage descriptor, milestone=checkpoint, artifact=doc suffix); the static reference (Act/e-guide) fixes the phase vocabulary.


[ASM-01] A referenceable PROJECT state must exist, and it is live, not static

  • Kind: Assumption
  • Status: active
  • Targets: project, reference, snapshot

Summary

Population presumes a project table the AICT reads at assessment time. Reality: EPIC has no project record system β€” the DFL must mint it. User values are never accepted raw; they're validated against project state β€” and the document under assessment may itself ADVANCE that state (decisions, orders, transfers, amendments). Hence the per-doc Project Snapshot = state at that moment, not forever. Reference home: C β†’ REFERENCE TABLES β†’ Projects.


[CAND-01] AICT "director" function isolates a targeted subset first

  • Kind: Candidate
  • Status: promoted
  • Source: A - Design Foundations
  • Targets: director, graze

Summary

Candidate position that has since been realized β€” promoted into DG-04 (the grazing pre-pass). Kept here for lineage.


⚠️ **GitHub.com Fallback** ⚠️