<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Joe Shepherd</title>
    <description>The latest articles on DEV Community by Joe Shepherd (@drjoeshepherd).</description>
    <link>https://dev.to/drjoeshepherd</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4252060%2Fcd6f1cd5-4feb-408e-a3c5-d37c8f26354b.png</url>
      <title>DEV Community: Joe Shepherd</title>
      <link>https://dev.to/drjoeshepherd</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/drjoeshepherd"/>
    <language>en</language>
    <item>
      <title>Which rule did your agent use?</title>
      <dc:creator>Joe Shepherd</dc:creator>
      <pubDate>Wed, 18 Nov 2026 14:06:58 +0000</pubDate>
      <link>https://dev.to/drjoeshepherd/which-rule-did-your-agent-use-4066</link>
      <guid>https://dev.to/drjoeshepherd/which-rule-did-your-agent-use-4066</guid>
      <description>&lt;p&gt;Ask that of an agent that just did something you didn't expect. If the rule lives in a system prompt, a rules file, a skill and a chat from last spring, the answer is "one of several." Each copy was right once. They drift, and nobody can say which one the agent read.&lt;/p&gt;

&lt;p&gt;We started SIGN to make agents reason more accurately over a company's rules. This post explains the mechanism and where it stops.&lt;/p&gt;

&lt;h2&gt;
  
  
  A paragraph is not a rule
&lt;/h2&gt;

&lt;p&gt;In a page of prose, a hard limit and a passing remark look the same to a model. "Refunds over $500 usually need a manager" and "refunds over $500 need a manager" read almost the same. The agent has to guess which one is binding.&lt;/p&gt;

&lt;p&gt;SIGN makes the difference explicit. Here is the example from the engineer guide:&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;@doc REFUND-001 [std, active, agents+employees] v1
@links REFUND-002
## Refunds over 500 dollars need a manager's approval before an agent issues them.

@rules
  1. An agent may issue a refund of 500 dollars or less without approval.
  2. A refund over 500 dollars needs approval from a support manager first.

@constraints
  manager-approval
    requires: support-manager approval on any refund over 500 dollars
    forbids: an agent issuing a refund over 500 dollars without that approval
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;

&lt;p&gt;The constraint says what it requires and what it forbids. The header carries a type, a status and a version. REFUND-002 defines who counts as a support manager, so the agent doesn't have to guess that either.&lt;/p&gt;

&lt;h2&gt;
  
  
  Index plus fetch
&lt;/h2&gt;

&lt;p&gt;Loading every rule into every prompt spends context on rules the task doesn't need. SIGN splits delivery in two. A compiler writes a short index the agent loads on every call. When a task needs a rule, the agent fetches the full document by its ID. The validator fails the build if the index grows past its budget, so it stays short.&lt;/p&gt;

&lt;p&gt;Status does real work here. The compiler only puts active documents in the bundle. When you retire a rule, it drops out, instead of living on in an old prompt.&lt;/p&gt;

&lt;h2&gt;
  
  
  What SIGN does not do
&lt;/h2&gt;

&lt;p&gt;SIGN is a notation and a set of tools. It doesn't decide who owns a rule. It doesn't approve a change. It enforces nothing at runtime. The reference tools are version 0.1 and will change faster than the spec.&lt;/p&gt;

&lt;p&gt;Ownership, approval and the record of which version an agent was served are a different layer. At Five Deep that layer is Charter. You don't need it to use SIGN.&lt;/p&gt;

&lt;h2&gt;
  
  
  Try it
&lt;/h2&gt;

&lt;p&gt;You need Git and Node.js 18 or later.&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;git clone https://github.com/sign-protocol/sign-lang.git
cd sign-lang
node validator/bin/sign.js validate --source examples
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;

&lt;p&gt;Expect warnings. The examples link to documents that aren't in the folder. Then write two documents of your own, one rule and one definition it links to, and compile them. The engineer guide walks through each step: &lt;a href="https://sign-protocol.github.io/sign-lang/engineers/" rel="noopener noreferrer"&gt;https://sign-protocol.github.io/sign-lang/engineers/&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;I'd like criticism on three things: whether typed blocks beat markdown with front matter for this, how the index budget should work, and the provenance model. Open an issue on sign-lang, or post what you built in the GitHub discussion.&lt;/p&gt;

&lt;p&gt;SIGN is open source under Apache 2.0. Five Deep maintains it.&lt;/p&gt;

</description>
      <category>ai</category>
      <category>opensource</category>
      <category>agents</category>
      <category>llm</category>
    </item>
  </channel>
</rss>
