Home /Modules/advantage/advantages.xml

advantages.xml

advantage/advantages.xml · 139 line(s) · xml

<?xml version="1.0" encoding="UTF-8"?>
<!--
  advantages.xml

  A store of assumptions and strings of knowledge for the advantage module.

  An "advantage" here is a source of leverage: something you can draw on to
  know, decide, or act with more effect than you otherwise could. Each
  source advantage below carries:
    - assumptions : what we take to be true in order to rely on this source
    - knowledge   : short strings of knowledge the source provides
    - evidence    : optional recorded outcomes, <observation reward= baseline=/>,
                    fed to the C advantage math by `analyze --counsel`. An
                    absent <evidence> means "unknown", never "zero".

  An <assumption status="doubted"> marks an assumption not currently trusted;
  unmarked assumptions are held. Doubted assumptions discount the source in
  the counsel ranking until they are verified.

  NOTE: the observations below are ILLUSTRATIVE SEED DATA that demonstrate the
  mechanism. They are not measurements. Replace them with your own outcomes.
-->
<advantages version="1.0">

  <!-- A source or a spring: an origin that keeps giving, a wellspring. -->
  <sourceAdvantage id="source-spring" kind="source">
    <name>Source / Spring</name>
    <description>An origin or wellspring that renews itself and keeps supplying.</description>
    <evidence weight="1.0">
      <observation reward="3.0" baseline="2.0"/>
      <observation reward="2.5" baseline="2.0"/>
      <observation reward="3.5" baseline="2.5"/>
      <observation reward="2.8" baseline="2.0"/>
    </evidence>
    <assumptions>
      <assumption>The source does not run dry under normal use.</assumption>
      <assumption>What flows from it is reasonably pure at the point of origin.</assumption>
      <assumption>Access to the origin is clearer than access downstream.</assumption>
    </assumptions>
    <knowledge>
      <string>Go upstream to the origin to find the cleanest signal.</string>
      <string>A renewing source outlasts any single stored quantity.</string>
    </knowledge>
  </sourceAdvantage>

  <!-- A mechanical advantage: leverage that multiplies applied effort. -->
  <sourceAdvantage id="mechanical-advantage" kind="mechanical">
    <name>Mechanical Advantage</name>
    <description>Leverage from a tool or machine that multiplies applied force.</description>
    <evidence weight="1.0">
      <observation reward="5.0" baseline="2.0"/>
      <observation reward="4.0" baseline="2.0"/>
      <observation reward="4.5" baseline="2.5"/>
      <observation reward="5.5" baseline="2.0"/>
      <observation reward="4.2" baseline="2.2"/>
      <observation reward="4.8" baseline="2.0"/>
    </evidence>
    <assumptions>
      <assumption>Input effort is traded for distance or speed, not created.</assumption>
      <assumption>The mechanism holds within its rated limits.</assumption>
      <assumption>A small, well-placed force can move a large load.</assumption>
    </assumptions>
    <knowledge>
      <string>Find the fulcrum; place effort where it multiplies.</string>
      <string>Ratio of output to input force defines the advantage.</string>
    </knowledge>
  </sourceAdvantage>

  <!-- A genius: insight that sees the answer others cannot. -->
  <sourceAdvantage id="genius" kind="intellect">
    <name>Genius</name>
    <description>Exceptional insight that reaches answers by a shorter path.</description>
    <!--
      Optional remote knowledge. Declaring a source does NOT fetch anything:
      the base loader is pure/offline. Fetching happens only via the opt-in,
      allowlisted enrichment path (see enrich.hpp). These examples are inert
      unless you run `analyze --enrich --allow-host <host>` (plus --allow-file for a file:// URL).
    -->
    <knowledgeSource url="file:///dev/null"/>
    <evidence weight="1.0">
      <observation reward="9.0" baseline="2.0"/>
      <observation reward="1.0" baseline="2.0"/>
    </evidence>
    <assumptions>
      <assumption>The insight is genuine and can be checked against reality.</assumption>
      <assumption>Brilliance does not guarantee being right every time.</assumption>
      <assumption>Rare understanding is worth seeking out and heeding.</assumption>
    </assumptions>
    <knowledge>
      <string>One clear mind can shorten a long search.</string>
      <string>Verify the leap of insight before you bet on it.</string>
    </knowledge>
  </sourceAdvantage>

  <!-- A kid: a plain, uncorrupted way of knowing what is right. -->
  <sourceAdvantage id="kid" kind="conscience">
    <name>Kid</name>
    <description>A plain, uncorrupted sense of what is right and fair.</description>
    <evidence weight="1.0">
      <observation reward="2.0" baseline="1.5"/>
      <observation reward="2.2" baseline="1.5"/>
      <observation reward="1.8" baseline="1.5"/>
      <observation reward="2.4" baseline="1.5"/>
    </evidence>
    <assumptions>
      <assumption>Simple honesty often sees fairness more clearly than cleverness.</assumption>
      <assumption>The obvious right answer is sometimes the correct one.</assumption>
      <assumption status="doubted">An unschooled conscience can still be trusted on fairness.</assumption>
    </assumptions>
    <knowledge>
      <string>If it feels plainly unfair, it probably is.</string>
      <string>Ask the simple question a child would ask.</string>
    </knowledge>
  </sourceAdvantage>

  <!-- Simple money: liquid means that can be exchanged for most things. -->
  <sourceAdvantage id="money" kind="economic">
    <name>Simple Money</name>
    <description>Liquid means of exchange that can be traded for most resources.</description>
    <evidence weight="1.0">
      <observation reward="3.0" baseline="2.5"/>
      <observation reward="2.0" baseline="2.2"/>
      <observation reward="3.4" baseline="2.4"/>
      <observation reward="2.6" baseline="2.5"/>
      <observation reward="3.1" baseline="2.6"/>
    </evidence>
    <assumptions>
      <assumption>Money is widely accepted in exchange for goods and effort.</assumption>
      <assumption>It is a means, not an end in itself.</assumption>
      <assumption>Some advantages cannot be bought with it.</assumption>
    </assumptions>
    <knowledge>
      <string>Liquidity buys options and time.</string>
      <string>Money converts to many advantages, but not all of them.</string>
    </knowledge>
  </sourceAdvantage>

</advantages>