@brainervirus/workit-claude-code 7.5.2 → 7.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +1 -1
- package/dist/workit-hook.js +1 -0
- package/dist/workit.js +6 -5
- package/package.json +3 -3
- package/skills/architecture/SKILL.md +72 -0
- package/skills/architecture/agents/openai.yaml +3 -0
- package/skills/architecture/references/instruction-files.md +52 -0
- package/skills/architecture/references/vocabulary.md +53 -0
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "workit",
|
|
3
3
|
"displayName": "Workit",
|
|
4
|
-
"version": "7.
|
|
4
|
+
"version": "7.6.0",
|
|
5
5
|
"description": "Workflow rails for agentic coding: task context on every session, branch policy on shell commands, and the workit method skills",
|
|
6
6
|
"author": {
|
|
7
7
|
"name": "BrainerVirus"
|
package/dist/workit-hook.js
CHANGED
|
@@ -59,6 +59,7 @@ Skills: load the skill, never act from memory of it (slash aliases /wk-<name>).
|
|
|
59
59
|
- fan out, parallelize, parallel agents, swarm: workit-fanout
|
|
60
60
|
- verify the app, smoke test, prove it works: workit-verify-app
|
|
61
61
|
- retro (user-invoked; offer it): workit-retro
|
|
62
|
+
- architecture, deepen modules (user-invoked; offer it): workit-architecture
|
|
62
63
|
`.trim();import{createHash as wy,randomUUID as Op}from"node:crypto";function Ir(e){let t=Object.values(e).filter((n)=>typeof n==="number");return Object.entries(e).filter(([n,o])=>t.indexOf(+n)===-1).map(([n,o])=>o)}function Ko(e,t="|"){return e.map((r)=>Go(r)).join(t)}function Rr(e,t){if(typeof t==="bigint")return t.toString();return t}class qa{constructor(e){this._getter=e,this._value=void 0}get value(){let e=this._getter;if(e!==void 0)this._value=e(),this._getter=void 0;return this._value}}function Tr(e){return new qa(e)}function Ua(e){return e===null||e===void 0}function fn(e){let t=e.startsWith("^")?1:0,r=e.endsWith("$")?e.length-1:e.length;return e.slice(t,r)}function hn(e,t){let r=e/t,n=Math.round(r),o=4*Number.EPSILON*Math.max(Math.abs(r),1);if(Math.abs(r-n)<o)return 0;return r-n}function Le(e,t,r){Object.defineProperty(e,t,{value:r,writable:!0,enumerable:!0,configurable:!0})}function Or(e){let t=Object.getOwnPropertyDescriptor(e,"shape");return t?.get?t.get.raw:t?.value}function Xe(e){return Or(e._zod.def)??e._zod.def.shape}function Ka(e,t,r){Object.defineProperty(e,t,{get(){let n=r();return Le(this,t,n),n},enumerable:!0,configurable:!0})}function Ja(e,t,r){if(t in e)Le(e,t,r);else e[t]=r}function Pt(e,t,r,n){let o=Xe(t);for(let s of r){let i=Object.getOwnPropertyDescriptor(o,s);if(!i.enumerable)continue;if(i.get)Ka(e,s,()=>{let a=t._zod.def.shape[s];return n?n(a,s):a});else Ja(e,s,n?n(i.value,s):i.value)}}function Cm(e,t){for(let r of Reflect.ownKeys(t)){let n=Object.getOwnPropertyDescriptor(t,r);if(!n.enumerable)continue;if(n.get)Ka(e,r,()=>t[r]);else Ja(e,r,n.value)}}function Te(...e){let t={};for(let r of e){let n=Object.getOwnPropertyDescriptors(r);Object.assign(t,n)}return Object.defineProperties({},t)}function be(e){return JSON.stringify(e)}function Ga(e){return e.toLowerCase().trim().replace(/[^\w\s-]/g,"").replace(/[\s_-]+/g,"-").replace(/^-+|-+$/g,"")}var Jo="captureStackTrace"in Error?Error.captureStackTrace:(...e)=>{};function Yt(e){return typeof e==="object"&&e!==null&&!Array.isArray(e)}var Ya=Tr(()=>{if(_e.jitless)return!1;if(typeof navigator<"u"&&navigator?.userAgent?.includes("Cloudflare"))return!1;try{return new Function(""),!0}catch(e){return!1}});function et(e){if(Yt(e)===!1)return!1;let t=e.constructor;if(t===void 0)return!0;if(typeof t!=="function")return!0;let r=t.prototype;if(Yt(r)===!1)return!1;if(Object.prototype.hasOwnProperty.call(r,"isPrototypeOf")===!1)return!1;return!0}function Cr(e){if(et(e))return{...e};if(Array.isArray(e))return[...e];if(e instanceof Map)return new Map(e);if(e instanceof Set)return new Set(e);return e}var Xa=new Set(["string","number","symbol"]);function ft(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function Oe(e,t,r){let n=new e._zod.constr(t??e._zod.def);if(!t||r?.parent)n._zod.parent=e;return n}function z(e){let t=e;if(!t)return{};if(typeof t==="string")return{error:()=>t};if(t?.message!==void 0){if(t?.error!==void 0)throw Error("Cannot specify both `message` and `error` params");t.error=t.message}if(delete t.message,typeof t.error==="string")return{...t,error:()=>t.error};return t}function Go(e){if(typeof e==="bigint")return e.toString()+"n";if(typeof e==="string")return`"${e}"`;return`${e}`}function Qa(e){return Object.keys(e).filter((t)=>e[t]._zod.optin!==void 0&&e[t]._zod.optout==="optional")}var mn=(()=>({safeint:[Number.MIN_SAFE_INTEGER,Number.MAX_SAFE_INTEGER],int32:[-2147483648,2147483647],uint32:[0,4294967295],float32:[-340282346638528860000000000000000000000,340282346638528860000000000000000000000],float64:[-Number.MAX_VALUE,Number.MAX_VALUE]}))(),Yo={int64:[BigInt("-9223372036854775808"),BigInt("9223372036854775807")],uint64:[BigInt(0),BigInt("18446744073709551615")]};function Pm(e,t){let r=e._zod.def,n=r.checks;if(n&&n.length>0)throw Error(".pick() cannot be used on object schemas containing refinements");let s={};return Pt(s,e,gn(e,t)),Oe(e,Te(r,{shape:s,checks:[]}))}function gn(e,t){let r=Xe(e),n=[];for(let o of Reflect.ownKeys(t)){if(!Object.getOwnPropertyDescriptor(r,o)?.enumerable)throw Error(`Unrecognized key: "${String(o)}"`);if(t[o])n.push(o)}return n}function zm(e,t){let r=e._zod.def,n=r.checks;if(n&&n.length>0)throw Error(".omit() cannot be used on object schemas containing refinements");let s=new Set(gn(e,t)),i={};return Pt(i,e,Reflect.ownKeys(Xe(e)).filter((a)=>!s.has(a))),Oe(e,Te(r,{shape:i,checks:[]}))}function Em(e,t){if(!et(t))throw Error("Invalid input to extend: expected a plain object");let r=e._zod.def.checks;if(r&&r.length>0){let o=Xe(e);for(let s of Reflect.ownKeys(t))if(Object.getOwnPropertyDescriptor(o,s)!==void 0)throw Error("Cannot overwrite keys on object schemas containing refinements. Use `.safeExtend()` instead.")}return Oe(e,Te(e._zod.def,{shape:ec(e,t)}))}function ec(e,t){let r={};return Pt(r,e,Reflect.ownKeys(Xe(e))),Cm(r,t),r}function Am(e,t){if(!et(t))throw Error("Invalid input to safeExtend: expected a plain object");return Oe(e,Te(e._zod.def,{shape:ec(e,t)}))}function Nm(e,t){if(!t?._zod?.def)throw Error("Invalid input to merge: expected an object schema. To merge a plain shape, use `.extend()`.");if(e._zod.def.checks?.length)throw Error(".merge() cannot be used on object schemas containing refinements. Use .safeExtend() instead.");let r={};Pt(r,e,Reflect.ownKeys(Xe(e))),Pt(r,t,Reflect.ownKeys(Xe(t)));let n=Te(e._zod.def,{shape:r,get catchall(){return t._zod.def.catchall},checks:t._zod.def.checks??[]});return Oe(e,n)}function tc(e,t,r,n="partial"){let s=t._zod.def.checks;if(s&&s.length>0)throw Error(`.${n}() cannot be used on object schemas containing refinements`);let a=r?new Set(gn(t,r)):void 0,c={};return Pt(c,t,Reflect.ownKeys(Xe(t)),e&&((u,l)=>a&&!a.has(l)?u:new e({type:"optional",innerType:u}))),Oe(t,Te(t._zod.def,{shape:c,checks:[]}))}function Lm(e,t,r){let n=r?new Set(gn(t,r)):void 0,o={};return Pt(o,t,Reflect.ownKeys(Xe(t)),(s,i)=>n&&!n.has(i)?s:new e({type:"nonoptional",innerType:s})),Oe(t,Te(t._zod.def,{shape:o}))}function Ue(e,t=0){if(e.aborted===!0)return!0;for(let r=t;r<e.issues.length;r++)if(e.issues[r]?.continue!==!0)return!0;return!1}function rc(e,t=0){if(e.aborted===!0)return!0;for(let r=t;r<e.issues.length;r++)if(e.issues[r]?.continue===!1)return!0;return!1}function ht(e,t){return t.map((r)=>{var n;return(n=r).path??(n.path=[]),r.path.unshift(e),r})}function $r(e){return typeof e==="string"?e:e?.message}function Xo(e,t,r){var n;for(let o=t;o<e.length;o++)(n=e[o]).schema??(n.schema=r)}function Ke(e,t,r){var n;let o=e.inst?._zod?.traits;if(o?.has("$ZodType"))if(o.has("$ZodCheck"))(n=e).schema??(n.schema=e.inst);else e.schema=e.inst;let s=e.schema!==e.inst?e.schema?._zod.def?.error:void 0,i=e.message?e.message:$r(e.inst?._zod.def?.error?.(e))??$r(s?.(e))??$r(t?.error?.(e))??$r(r.customError?.(e))??$r(r.localeError?.(e))??"Invalid input",a={};for(let c of Object.keys(e)){if(c==="inst"||c==="schema"||c==="continue"||c==="input"||c==="__proto__")continue;a[c]=e[c]}if(a.path??(a.path=[]),a.message=i,t?.reportInput)a.input=e.input;return a}var Dm=/[\uD800-\uDBFF]/;function Xt(e){let t=e.length;if(!Dm.test(e))return t;let r=t;for(let n=0;n<t-1;n++)if((e.charCodeAt(n)&64512)===55296&&(e.charCodeAt(n+1)&64512)===56320)r--,n++;return r}function kn(e){if(Array.isArray(e))return"array";if(typeof e==="string")return"string";return"unknown"}function nc(e){let t=typeof e;switch(t){case"number":return Number.isNaN(e)?"nan":"number";case"object":{if(e===null)return"null";if(Array.isArray(e))return"array";let r=e;if(r&&Object.getPrototypeOf(r)!==Object.prototype&&"constructor"in r&&r.constructor)return r.constructor.name}}return t}function zt(...e){let[t,r,n]=e;if(typeof t==="string")return{message:t,code:"custom",input:r,inst:n};return{...t}}function oc(e,t){for(let r in t){let n=Object.getOwnPropertyDescriptor(t,r);if(n.get)Object.defineProperty(e,r,{...n,enumerable:!1});else jm(e,r,n.value)}}function Qe(e,t,r,n=!0){return Object.defineProperty(e,t,{configurable:!0,writable:!0,enumerable:n,value:r}),r}function yn(e,t,r){return Qe(e,t,r,!1)}function sc(e,t){for(let r in e){let n=e[r];Object.defineProperty(t,r,{configurable:!0,enumerable:!0,get(){return Qe(this,r,n(this))},set(o){Qe(this,r,o)}})}return t}function jm(e,t,r){Object.defineProperty(e,t,{configurable:!0,get(){return this==null?r:Qe(this,t,r.bind(this))},set(n){Qe(this,t,n)}})}function Fm(e,t){let r=Object.getPrototypeOf(e);return t in r?void 0:r}var Uo,pt=!1,Wm={configurable:!0,get(){pt=!0;return}};function B(e,t,r){let n=Object.getPrototypeOf(e._zod);if(t in n&&Uo!==e._zod){Uo=void 0;return}Uo=e._zod,Object.defineProperty(n,t,{configurable:!0,get(){Object.defineProperty(this,t,Wm);let o=pt;pt=!1;try{let s=r(this);if(pt)delete this[t];else Object.defineProperty(this,t,{configurable:!0,writable:!0,value:s});return pt=pt||o,s}catch(s){throw delete this[t],pt=pt||o,s}},set(o){Object.defineProperty(this,t,{configurable:!0,writable:!0,value:o})}})}function Zm(e,t,r,n){let o=Fm(e,t);if(!o)return;Object.defineProperty(o,t,{configurable:!0,get(){let s={configurable:!0,writable:!0,enumerable:n,value:void 0};return Object.defineProperty(this,t,s),s.value=r(this),Object.defineProperty(this,t,s),s.value},set(s){Object.defineProperty(this,t,{configurable:!0,writable:!0,enumerable:n,value:s})}})}var Qo="~constantCatch";function ic(e){let t=()=>e;return t[Qo]=!0,t}var ac;var es={value:void 0,enumerable:!1},cc="captureStackTrace"in Error?Error:null;function Bm(e){let t=cc;if(t){let r=t.stackTraceLimit;if(typeof r==="number"){try{t.stackTraceLimit=0}catch{return cc=null,new e}try{return new e}finally{t.stackTraceLimit=r}}}return new e}function w(e,t,r,n){let o={};function s(p){this.def=p,this.constr=d,this.traits=new Set}s.prototype=o;let i=r,a=i&&new WeakSet;function c(p,f){if(!p._zod){es.value=new s(f);try{Object.defineProperty(p,"_zod",es)}finally{es.value=void 0}}else if(p._zod.traits.has(e))return;if(p._zod.traits.add(e),t(p,f),a){let m=Object.getPrototypeOf(p),y=p._zod.constr.prototype,v=m;while(v&&v!==y)v=Object.getPrototypeOf(v);let k=v??m;if(!a.has(k))a.add(k),oc(k,i)}let h=d.prototype;for(let m in h){if(!Object.prototype.hasOwnProperty.call(h,m))continue;if(!(m in p))p[m]=h[m].bind(p)}}let u=n?.Parent??Object;class l extends u{}Object.defineProperty(l,"name",{value:e});function d(p){let f=n?.Parent?Bm(l):this;c(f,p);let h=f._zod.deferred;if(h){for(let y of h)y();f._zod.deferred=void 0}let m=globalThis.__zod_globalConfig?.postProcessor;if(m)m(f);return f}return Object.defineProperty(d,"init",{value:c}),Object.defineProperty(d,Symbol.hasInstance,{value:(p)=>{if(n?.Parent&&p instanceof n.Parent)return!0;return p?._zod?.traits?.has(e)}}),Object.defineProperty(d,"name",{value:e}),d}class De extends Error{constructor(){super("Encountered Promise during synchronous parse. Use .parseAsync() instead.")}}class Pr extends Error{constructor(e){super(`Encountered unidirectional transform during encode: ${e}`);this.name="ZodEncodeError"}}(ac=globalThis).__zod_globalConfig??(ac.__zod_globalConfig={});var _e=globalThis.__zod_globalConfig;function xe(e){if(e)Object.assign(_e,e);return _e}function Mm(){let e=this._zod;return e.message??(e.message=JSON.stringify(e.def,Rr,2)),e.message}function Vm(e){this._zod.message=e}var Hm={get:Mm,set:Vm,enumerable:!0,configurable:!0},rs={value:void 0,enumerable:!1},uc=new WeakSet([Object.prototype,Error.prototype]),lc=(e,t)=>{e.name="$ZodError",rs.value=t,Object.defineProperty(e,"issues",rs),rs.value=void 0,Object.defineProperty(e,"message",Hm);let r=Object.getPrototypeOf(e);if(!uc.has(r))uc.add(r),Object.defineProperty(r,"toString",{configurable:!0,enumerable:!1,get(){let n=()=>this.message;return Object.defineProperty(this,"toString",{value:n,configurable:!0,writable:!0}),n},set(n){Object.defineProperty(this,"toString",{value:n,configurable:!0,writable:!0})}})},dc=w("$ZodError",lc),vx=w("$ZodError",lc,void 0,{Parent:Error});function qm(e,t,r){if(!Object.prototype.hasOwnProperty.call(e,t))if(t==="__proto__")Object.defineProperty(e,t,{value:r(),writable:!0,enumerable:!0,configurable:!0});else e[t]=r();return e[t]}function ns(e,t=(r)=>r.message){let r={},n=[];for(let o of e.issues)if(o.path.length>0)qm(r,o.path[0],()=>[]).push(t(o));else n.push(t(o));return{formErrors:n,fieldErrors:r}}function os(e,t=(r)=>r.message){let r={_errors:[]},n=(o,s=[])=>{for(let i of o.issues)if(i.code==="invalid_union"&&i.errors.length)i.errors.map((a)=>n({issues:a},[...s,...i.path]));else if(i.code==="invalid_key")n({issues:i.issues},[...s,...i.path]);else if(i.code==="invalid_element")n({issues:i.issues},[...s,...i.path]);else{let a=[...s,...i.path];if(a.length===0)r._errors.push(t(i));else{let c=r,u=0;while(u<a.length){let l=a[u],d=u===a.length-1;if(l==="_errors"){if(d)c._errors.push(t(i));u++;continue}if(!Object.prototype.hasOwnProperty.call(c,l))Object.defineProperty(c,l,{value:{_errors:[]},enumerable:!0,writable:!0,configurable:!0});let p=c[l];if(d)p._errors.push(t(i));c=p,u++}}}};return n(e),r}function vn(e,t){return{callee:t?.callee??e,Err:t?.Err}}var wn=(e)=>{let t=(r,n,o,s)=>{let i=o?{...o,async:!1}:{async:!1},a=r._zod.run({value:n,issues:[]},i);if(a instanceof Promise)throw new De;if(a.issues.length){let c=new(s?.Err??e)(a.issues.map((u)=>Ke(u,i,xe())));throw Jo(c,s?.callee??t),c}return a.value};return t};var bn=(e)=>{let t=async(r,n,o,s)=>{let i=o?{...o,async:!0}:{async:!0},a=r._zod.run({value:n,issues:[]},i);if(a instanceof Promise)a=await a;if(a.issues.length){let c=new(s?.Err??e)(a.issues.map((u)=>Ke(u,i,xe())));throw Jo(c,s?.callee??t),c}return a.value};return t};var _n=(e)=>(t,r,n)=>{let o=n?{...n,async:!1}:{async:!1},s=t._zod.run({value:r,issues:[]},o);if(s instanceof Promise)throw new De;return s.issues.length?pc(e,s.issues,o):{success:!0,data:s.value}};function pc(e,t,r){let n;return{success:!1,get error(){if(!n)n=new e(t.map((o)=>Ke(o,r,xe()))),t=void 0,r=void 0;return n},set error(o){n=o,t=void 0,r=void 0}}}var xn=(e)=>async(t,r,n)=>{let o=n?{...n,async:!0}:{async:!0},s=t._zod.run({value:r,issues:[]},o);if(s instanceof Promise)s=await s;return s.issues.length?pc(e,s.issues,o):{success:!0,data:s.value}};var Um=Symbol.for("zod.compile.invalid"),Km=Symbol.for("zod.compile.fallback"),ss=(e,t,r)=>{let n=e._zod.bag.validator;if(n!==void 0){if(n(t)!==Um)return!0;if(n.definite===!0&&r===void 0)return!1}return Jm(e,t,r)};function Jm(e,t,r){let n=r?{...r,async:!1,abortEarly:!0}:{async:!1,abortEarly:!0},o=e._zod.bag.fallbackRun,s;if(o)n[Km]=!0,s=o({value:t,issues:[]},n);else s=e._zod.run({value:t,issues:[]},n);if(s instanceof Promise)throw new De;return s.issues.length===0}var is=async(e,t,r)=>{let n=r?{...r,async:!0,abortEarly:!0}:{async:!0,abortEarly:!0},o=e._zod.run({value:t,issues:[]},n);if(o instanceof Promise)o=await o;return o.issues.length===0},fc=(e)=>{let t=wn(e),r=(n,o,s,i)=>{let a=s?{...s,direction:"backward"}:{direction:"backward"};return t(n,o,a,vn(r,i))};return r};var hc=(e)=>{let t=wn(e),r=(n,o,s,i)=>t(n,o,s,vn(r,i));return r};var mc=(e)=>{let t=bn(e),r=async(n,o,s,i)=>{let a=s?{...s,direction:"backward"}:{direction:"backward"};return await t(n,o,a,vn(r,i))};return r};var gc=(e)=>{let t=bn(e),r=async(n,o,s,i)=>await t(n,o,s,vn(r,i));return r};var kc=(e)=>(t,r,n)=>{let o=n?{...n,direction:"backward"}:{direction:"backward"};return _n(e)(t,r,o)};var yc=(e)=>(t,r,n)=>_n(e)(t,r,n);var vc=(e)=>async(t,r,n)=>{let o=n?{...n,direction:"backward"}:{direction:"backward"};return xn(e)(t,r,o)};var wc=(e)=>async(t,r,n)=>xn(e)(t,r,n);var bc=/^[cC][0-9a-z]{6,}$/,_c=/^[0-9a-z]+$/,xc=/^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/,Sc=/^[0-9a-vA-V]{20}$/,$c=/^[A-Za-z0-9]{27}$/,Ic=/^[a-zA-Z0-9_-]{21}$/;function Rc(e){return new RegExp(`^[a-zA-Z0-9_-]{${e}}$`)}var Tc=/^P(?:(\d+W)|(?!.*W)(?=\d|T\d)(\d+Y)?(\d+M)?(\d+D)?(T(?=\d)(\d+H)?(\d+M)?(\d+([.,]\d+)?S)?)?)$/;var Oc=/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$/,cs=(e)=>{if(!e)return/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/;return new RegExp(`^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-${e}[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$`)};var Cc=/^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$/;var Gm="^(?=[\\s\\S]*[\\p{Extended_Pictographic}\\p{Regional_Indicator}\\u20E3])[\\p{Extended_Pictographic}\\p{Emoji_Component}]+$";function Pc(){return new RegExp(Gm,"u")}var zc=/^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])$/,Ec=/^(([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:))$/;var Ac=/^((25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\/([0-9]|[1-2][0-9]|3[0-2])$/,Nc=/^(([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:))\/(12[0-8]|1[01][0-9]|[1-9]?[0-9])$/,Lc=/^$|^(?:[0-9a-zA-Z+/]{4})*(?:(?:[0-9a-zA-Z+/]{2}==)|(?:[0-9a-zA-Z+/]{3}=))?$/,Dc=/^(?:[A-Za-z0-9_-]{4})*(?:[A-Za-z0-9_-]{2,3})?$/;var jc=/^https?$/,Fc=/^\+[1-9]\d{6,14}$/,Wc=/^\d(?:[ -]?\d){11,18}$/;var Zc=/^[A-Z]{2}(?!00|01|99)\d{2}[A-Z0-9]{11,30}$/,Bc="(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))";function Ym(e){return new RegExp(`^${e}$`)}var Mc=Ym(Bc);function as(e){return typeof e.precision==="number"?e.precision===-1?"(?:[01]\\d|2[0-3]):[0-5]\\d":e.precision===0?"(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d":`(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{${e.precision}}`:e.seconds?"(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?":"(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?"}function Vc(e){return new RegExp(`^${as(e)}$`)}function Hc(e){let t=["Z"];if(e.offset)t.push("([+-](?:[01]\\d|2[0-3]):[0-5]\\d)");let r=`${as({precision:e.precision,seconds:!0})}(?:${t.join("|")})`,n=e.local?`${r}|${as({precision:e.precision})}`:r;return new RegExp(`^${Bc}T(?:${n})$`)}var qc=/^[\s\S]{0,}$/;var us=/^-?\d+$/,Et=/^-?\d+(?:\.\d+)?$/,Uc=/^(?:true|false)$/i;var Kc=/^[^A-Z]*$/,Jc=/^[^a-z]*$/;var ue=w("$ZodCheck",(e,t)=>{var r;e._zod??(e._zod={}),e._zod.def=t,(r=e._zod).onattach??(r.onattach=[])});var ls=(e)=>{let t=e.value;return!Ua(t)&&t.length!==void 0},Sn={number:"number",bigint:"bigint",object:"date"},ds=w("$ZodCheckLessThan",(e,t)=>{ue.init(e,t);let r=Sn[typeof t.value];e._zod.check=(n)=>{if(t.inclusive?n.value<=t.value:n.value<t.value)return;n.issues.push({origin:Sn[typeof n.value]??r,code:"too_big",maximum:typeof t.value==="object"?t.value.getTime():t.value,input:n.value,inclusive:t.inclusive,inst:e,continue:!t.abort})}}),ps=w("$ZodCheckGreaterThan",(e,t)=>{ue.init(e,t);let r=Sn[typeof t.value];e._zod.check=(n)=>{if(t.inclusive?n.value>=t.value:n.value>t.value)return;n.issues.push({origin:Sn[typeof n.value]??r,code:"too_small",minimum:typeof t.value==="object"?t.value.getTime():t.value,input:n.value,inclusive:t.inclusive,inst:e,continue:!t.abort})}}),Gc=w("$ZodCheckMultipleOf",(e,t)=>{ue.init(e,t),e._zod.check=(r)=>{if(typeof r.value!==typeof t.value)throw Error("Cannot mix number and bigint in multiple_of check.");if(typeof r.value==="bigint"?t.value!==BigInt(0)&&r.value%t.value===BigInt(0):hn(r.value,t.value)===0)return;r.issues.push({origin:typeof r.value,code:"not_multiple_of",divisor:t.value,input:r.value,inst:e,continue:!t.abort})}}),Yc=w("$ZodCheckNumberFormat",(e,t)=>{ue.init(e,t),t.format=t.format||"float64";let r=t.format?.includes("int"),n=r?"int":"number",[o,s]=mn[t.format];e._zod.check=(i)=>{let a=i.value;if(r){if(!Number.isInteger(a)){i.issues.push({expected:n,format:t.format,code:"invalid_type",continue:!1,input:a,inst:e});return}if(!Number.isSafeInteger(a)){if(a>0)i.issues.push({input:a,code:"too_big",maximum:Number.MAX_SAFE_INTEGER,note:"Integers must be within the safe integer range.",inst:e,origin:n,inclusive:!0,continue:!t.abort});else i.issues.push({input:a,code:"too_small",minimum:Number.MIN_SAFE_INTEGER,note:"Integers must be within the safe integer range.",inst:e,origin:n,inclusive:!0,continue:!t.abort});return}}if(a<o)i.issues.push({origin:"number",input:a,code:"too_small",minimum:o,inclusive:!0,inst:e,continue:!t.abort});if(a>s)i.issues.push({origin:"number",input:a,code:"too_big",maximum:s,inclusive:!0,inst:e,continue:!t.abort})}});var Xc=w("$ZodCheckMaxLength",(e,t)=>{var r;ue.init(e,t),(r=e._zod.def).when??(r.when=ls),e._zod.check=(n)=>{let o=n.value,s=o.length;if((typeof o==="string"&&s>t.maximum?Xt(o):s)<=t.maximum)return;let a=kn(o);n.issues.push({origin:a,code:"too_big",maximum:t.maximum,inclusive:!0,input:o,inst:e,continue:!t.abort})}}),Qc=w("$ZodCheckMinLength",(e,t)=>{var r;ue.init(e,t),(r=e._zod.def).when??(r.when=ls),e._zod.check=(n)=>{let o=n.value,s=o.length;if((typeof o==="string"&&s>=t.minimum&&s<t.minimum*2?Xt(o):s)>=t.minimum)return;let a=kn(o);n.issues.push({origin:a,code:"too_small",minimum:t.minimum,inclusive:!0,input:o,inst:e,continue:!t.abort})}}),eu=w("$ZodCheckLengthEquals",(e,t)=>{var r;ue.init(e,t),(r=e._zod.def).when??(r.when=ls),e._zod.check=(n)=>{let o=n.value,s=o.length,i=typeof o==="string"&&s>=t.length&&s<=t.length*2?Xt(o):s;if(i===t.length)return;let a=kn(o),c=i>t.length;n.issues.push({origin:a,...c?{code:"too_big",maximum:t.length}:{code:"too_small",minimum:t.length},inclusive:!0,exact:!0,input:n.value,inst:e,continue:!t.abort})}}),zr=w("$ZodCheckStringFormat",(e,t)=>{var r,n;if(ue.init(e,t),t.pattern)(r=e._zod).check??(r.check=(o)=>{if(t.pattern.lastIndex=0,t.pattern.test(o.value))return;o.issues.push({origin:"string",code:"invalid_format",format:t.format,input:o.value,...t.pattern?{pattern:t.pattern.toString()}:{},inst:e,continue:!t.abort})});else(n=e._zod).check??(n.check=()=>{})}),tu=w("$ZodCheckRegex",(e,t)=>{zr.init(e,t),e._zod.check=(r)=>{if(t.pattern.lastIndex=0,t.pattern.test(r.value))return;r.issues.push({origin:"string",code:"invalid_format",format:"regex",input:r.value,pattern:t.pattern.toString(),inst:e,continue:!t.abort})}}),ru=w("$ZodCheckLowerCase",(e,t)=>{t.pattern??(t.pattern=Kc),zr.init(e,t)}),nu=w("$ZodCheckUpperCase",(e,t)=>{t.pattern??(t.pattern=Jc),zr.init(e,t)}),ou=w("$ZodCheckIncludes",(e,t)=>{ue.init(e,t);let r=ft(t.includes),n=new RegExp(typeof t.position==="number"?`^.{${t.position},}${r}`:r);t.pattern=n,e._zod.check=(o)=>{if(o.value.includes(t.includes,t.position))return;o.issues.push({origin:"string",code:"invalid_format",format:"includes",includes:t.includes,input:o.value,inst:e,continue:!t.abort})}}),su=w("$ZodCheckStartsWith",(e,t)=>{ue.init(e,t);let r=new RegExp(`^${ft(t.prefix)}.*`);t.pattern??(t.pattern=r),e._zod.check=(n)=>{if(n.value.startsWith(t.prefix))return;n.issues.push({origin:"string",code:"invalid_format",format:"starts_with",prefix:t.prefix,input:n.value,inst:e,continue:!t.abort})}}),iu=w("$ZodCheckEndsWith",(e,t)=>{ue.init(e,t);let r=new RegExp(`.*${ft(t.suffix)}$`);t.pattern??(t.pattern=r),e._zod.check=(n)=>{if(n.value.endsWith(t.suffix))return;n.issues.push({origin:"string",code:"invalid_format",format:"ends_with",suffix:t.suffix,input:n.value,inst:e,continue:!t.abort})}});var au=w("$ZodCheckOverwrite",(e,t)=>{ue.init(e,t),e._zod.check=(r)=>{r.value=t.tx(r.value)}});class Er{constructor(e=[],t={}){this.content=[],this.indent=0,this.args=e,this.closed=t}indented(e){this.indent+=1;try{e(this)}finally{this.indent-=1}}write(e){if(typeof e==="function"){e(this,{execution:"sync"}),e(this,{execution:"async"});return}let r=e.split(`
|
|
63
64
|
`).filter((s)=>s),n=Math.min(...r.map((s)=>s.length-s.trimStart().length)),o=r.map((s)=>s.slice(n)).map((s)=>" ".repeat(this.indent*2)+s);for(let s of o)this.content.push(s)}compile(){let e=Function,t=this?.content??[""];return new e(...Object.keys(this.closed),`return function (${this.args.join(", ")}) {
|
|
64
65
|
${t.join(`
|
package/dist/workit.js
CHANGED
|
@@ -65,7 +65,7 @@ var package_default;
|
|
|
65
65
|
var init_package = __esm(() => {
|
|
66
66
|
package_default = {
|
|
67
67
|
name: "@brainervirus/workit-cli",
|
|
68
|
-
version: "7.
|
|
68
|
+
version: "7.6.0",
|
|
69
69
|
private: false,
|
|
70
70
|
description: "Workit CLI — setup wizard, doctor, and task control for agentic coding workflows",
|
|
71
71
|
keywords: [
|
|
@@ -103,9 +103,9 @@ var init_package = __esm(() => {
|
|
|
103
103
|
},
|
|
104
104
|
dependencies: {
|
|
105
105
|
"@babel/parser": "7.29.9",
|
|
106
|
-
"@brainervirus/workit-core": "^7.
|
|
107
|
-
"@brainervirus/workit-cursor": "^7.
|
|
108
|
-
"@brainervirus/workit-opencode": "^7.
|
|
106
|
+
"@brainervirus/workit-core": "^7.6.0",
|
|
107
|
+
"@brainervirus/workit-cursor": "^7.6.0",
|
|
108
|
+
"@brainervirus/workit-opencode": "^7.6.0",
|
|
109
109
|
"@inkjs/ui": "2.0.0",
|
|
110
110
|
ink: "7.1.1",
|
|
111
111
|
react: "19.2.8"
|
|
@@ -63145,7 +63145,8 @@ var init_skill_manifests = __esm(() => {
|
|
|
63145
63145
|
"workit-deslop",
|
|
63146
63146
|
"workit-fanout",
|
|
63147
63147
|
"workit-verify-app",
|
|
63148
|
-
"workit-retro"
|
|
63148
|
+
"workit-retro",
|
|
63149
|
+
"workit-architecture"
|
|
63149
63150
|
];
|
|
63150
63151
|
if (false) {}
|
|
63151
63152
|
});
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@brainervirus/workit-claude-code",
|
|
3
|
-
"version": "7.
|
|
3
|
+
"version": "7.6.0",
|
|
4
4
|
"private": false,
|
|
5
5
|
"description": "Workit Claude Code plugin — session and per-turn task context, branch policy on git shell commands, workit method skills, and verifier/reviewer/implementer agents",
|
|
6
6
|
"keywords": [
|
|
@@ -39,8 +39,8 @@
|
|
|
39
39
|
"build": "bun scripts/build.ts"
|
|
40
40
|
},
|
|
41
41
|
"devDependencies": {
|
|
42
|
-
"@brainervirus/workit-cli": "^7.
|
|
43
|
-
"@brainervirus/workit-core": "^7.
|
|
42
|
+
"@brainervirus/workit-cli": "^7.6.0",
|
|
43
|
+
"@brainervirus/workit-core": "^7.6.0"
|
|
44
44
|
},
|
|
45
45
|
"engines": {
|
|
46
46
|
"node": ">=24"
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: architecture
|
|
3
|
+
description: Rank cited deepening refactors from churn and ledger friction; never applied unapproved. Use for architecture.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Architecture: deepen the modules that cause friction
|
|
8
|
+
|
|
9
|
+
User-invoked: offer it, never start it yourself. It proposes and grills; it
|
|
10
|
+
never refactors without the user's approval. Use the words in
|
|
11
|
+
`references/vocabulary.md` exactly and the domain words in `GLOSSARY.md`.
|
|
12
|
+
|
|
13
|
+
## Deepening
|
|
14
|
+
|
|
15
|
+
1. **Scope by YAGNI.** A direction the user names wins. Otherwise find hot
|
|
16
|
+
spots: churn (`git log --since=6.months --name-only --format=`, counted per
|
|
17
|
+
file, skipping lockfiles, version-bump manifests, generated files, docs and
|
|
18
|
+
`chore(release)` commits), friction in `workit ledger list --last 200`
|
|
19
|
+
(failed checks and verdicts, rulings, `retro:` decisions) and
|
|
20
|
+
`workit test-audit <paths> --json`. State the window and paths in one line.
|
|
21
|
+
2. **Settled decisions stand.** Read `GLOSSARY.md`, `CODING_STANDARDS.md` and
|
|
22
|
+
ADRs when present. Never re-litigate an ADR without new evidence.
|
|
23
|
+
3. **Explore organically.** A read-only explorer (Claude Code: Explore; or
|
|
24
|
+
you) walks the hot spots under the limits in `references/vocabulary.md`
|
|
25
|
+
and returns cited friction. Run the deletion test on every suspect.
|
|
26
|
+
4. **Report 3-5 ranked candidates, then stop and wait for approval.** Each:
|
|
27
|
+
- files and modules;
|
|
28
|
+
- the friction, with **2 or more cited occurrences** (commit, ledger row,
|
|
29
|
+
PR, test-audit finding); a one-off is not a candidate;
|
|
30
|
+
- an interface sketch: what callers see, what moves behind the seam;
|
|
31
|
+
- what gets simpler and what becomes testable through that interface;
|
|
32
|
+
- **merge danger**: one-way or two-way door, plus blast radius (callers,
|
|
33
|
+
packages, public surface).
|
|
34
|
+
The text list is primary; offer an HTML report only if the host renders one.
|
|
35
|
+
5. **Grill the chosen one**: numbered questions, each with a recommended
|
|
36
|
+
answer; challenge a weak premise with evidence first. Settle the interface,
|
|
37
|
+
the seam, the tests to replace and the migration order; a module named for
|
|
38
|
+
a new concept gets its glossary entry (call the Skill tool with `workit:shape`).
|
|
39
|
+
6. **Hand off on approval.** Several slices go into a plan for
|
|
40
|
+
`workit fanout plan <plan.json>`, with scopes and dependencies
|
|
41
|
+
(call the Skill tool with `workit:fanout`). One slice goes to a build (call the Skill tool with `workit:implement`). Record the
|
|
42
|
+
choice with `workit ledger decision "architecture: <id>" --why "<why>"`;
|
|
43
|
+
offer an ADR for a lasting rejection so the next run does not repeat it.
|
|
44
|
+
|
|
45
|
+
## Instruction files
|
|
46
|
+
|
|
47
|
+
Restructure AGENTS.md or CLAUDE.md in three escalating passes, **each its own
|
|
48
|
+
commit in one PR**, so the user can drop the later ones: remove no-ops;
|
|
49
|
+
progressive disclosure into topic files; coding rules to `CODING_STANDARDS.md`
|
|
50
|
+
and mechanical rules to checks. No commit adds a `workit knowledge lint`
|
|
51
|
+
finding. Never scaffold an empty file (`references/instruction-files.md`).
|
|
52
|
+
|
|
53
|
+
## Test sweep
|
|
54
|
+
|
|
55
|
+
Run `workit test-audit <paths> --json` over the suite or one hot spot and
|
|
56
|
+
report findings by module, worst first. On approval, the bad tests are
|
|
57
|
+
replaced (call the Skill tool with `workit:test-audit`).
|
|
58
|
+
|
|
59
|
+
## Example
|
|
60
|
+
|
|
61
|
+
Bad: "The CLI is messy, so I split router.ts in five." Uncited, unapproved.
|
|
62
|
+
|
|
63
|
+
Good: "1. Check runner (check.ts, evidence.ts), 3 occurrences: commits a1b2c3
|
|
64
|
+
and d4e5f6 edit both for one fix; ledger row 41 is a `check` red on a hidden
|
|
65
|
+
timeout. Sketch: `runCheck(spec)` returns evidence, the timeout behind it, so
|
|
66
|
+
timeouts test without a shell. Two-way door, 2 callers in one package."
|
|
67
|
+
|
|
68
|
+
## Check
|
|
69
|
+
|
|
70
|
+
```sh
|
|
71
|
+
workit knowledge lint # no new finding after each instruction-files commit
|
|
72
|
+
```
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# Instruction-files mode (AGENTS.md, CLAUDE.md)
|
|
2
|
+
|
|
3
|
+
Instruction files are paid for in every session that reads them. Restructure
|
|
4
|
+
them in three escalating passes. Each pass is its own commit in one PR, in
|
|
5
|
+
this order, so the user can keep pass 1 and drop pass 3. Run
|
|
6
|
+
`workit knowledge lint` before pass 1 and after every commit: no commit adds
|
|
7
|
+
a finding, and the lint exits 0 after the last pass, or the report lists the
|
|
8
|
+
findings that remain and why.
|
|
9
|
+
|
|
10
|
+
After each commit, run `workit check test`. A sentence a test pins stays,
|
|
11
|
+
unless the user approves changing that test. Commit each pass with
|
|
12
|
+
`workit git commit -m "<type>: <pass>" -- <paths>`, then open the PR
|
|
13
|
+
(call the Skill tool with `workit:ship`).
|
|
14
|
+
|
|
15
|
+
Before pass 1, report the current byte counts and the plan for each pass, then
|
|
16
|
+
wait for approval. A pass with nothing to do is skipped and said so, not
|
|
17
|
+
padded.
|
|
18
|
+
|
|
19
|
+
## Pass 1: remove no-ops
|
|
20
|
+
|
|
21
|
+
Delete lines that would change no behavior if removed: "be thorough", "write
|
|
22
|
+
clean code", "follow best practices", restated defaults of the host, notes
|
|
23
|
+
about one past session, `path:line` references, and rules whose mistake a type,
|
|
24
|
+
lint or check now prevents. Nothing moves in this pass; it only deletes.
|
|
25
|
+
|
|
26
|
+
## Pass 2: progressive disclosure
|
|
27
|
+
|
|
28
|
+
Keep the root file to what every session needs: commands, workflow, and
|
|
29
|
+
"Read before <task>: <file>" pointers. Move topic detail (testing, release,
|
|
30
|
+
hosts, architecture) into topic files under an existing docs folder, one file
|
|
31
|
+
per topic, each opened by when to read it. Move text verbatim first; rewording
|
|
32
|
+
belongs in pass 1 or a later change. Every pointer from AGENTS.md or
|
|
33
|
+
CLAUDE.md must resolve (the lint's `broken-link` rule). The lint does not read
|
|
34
|
+
topic files: check their own links and content by hand.
|
|
35
|
+
|
|
36
|
+
## Pass 3: standards and checks
|
|
37
|
+
|
|
38
|
+
- A judgment rule a reviewer must weigh goes to `CODING_STANDARDS.md`; the
|
|
39
|
+
root file keeps one pointer to it.
|
|
40
|
+
- A mechanical rule (a forbidden import, a naming pattern, a file that must
|
|
41
|
+
exist) becomes a check instead of prose: a lint rule, a test, or a
|
|
42
|
+
configured `workit check <name>`. Show the check failing on a planted
|
|
43
|
+
violation, then delete the sentence.
|
|
44
|
+
- No rule lives in two files (`duplicate-rule`).
|
|
45
|
+
|
|
46
|
+
## Never
|
|
47
|
+
|
|
48
|
+
- Create a file without its first real entry in the same commit. The lint
|
|
49
|
+
flags a scaffolded `CODING_STANDARDS.md` or `GLOSSARY.md` (`scaffold-file`);
|
|
50
|
+
for a topic file, that check is yours.
|
|
51
|
+
- Squash the passes into one commit, or mix a behavior change into them.
|
|
52
|
+
- Grow the root file past the lint's byte budget (`agents-budget`).
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
# Deepening vocabulary
|
|
2
|
+
|
|
3
|
+
Use these words exactly in every candidate. Do not drift into "component",
|
|
4
|
+
"service", "API" or "boundary".
|
|
5
|
+
|
|
6
|
+
| Term | Meaning |
|
|
7
|
+
| --- | --- |
|
|
8
|
+
| Module | Anything with an interface and an implementation: a function, a file, a package, a slice across tiers |
|
|
9
|
+
| Interface | Everything a caller must know: types, invariants, ordering, error modes, configuration, cost |
|
|
10
|
+
| Depth | Behavior a caller or test reaches per unit of interface learned. Deep: much behind little. Shallow: the interface is nearly as complex as the implementation |
|
|
11
|
+
| Seam | Where behavior can change without editing that place; where an interface lives |
|
|
12
|
+
| Adapter | A concrete thing that fills a seam (production, in-memory, fake) |
|
|
13
|
+
| Leverage | What callers gain from depth: one implementation pays back across many call sites and tests |
|
|
14
|
+
| Locality | What maintainers gain: change, bugs and verification concentrate in one place |
|
|
15
|
+
|
|
16
|
+
## Tests to run on a suspect
|
|
17
|
+
|
|
18
|
+
- **Deletion test.** Imagine deleting the module. Complexity vanishes: it was
|
|
19
|
+
a pass-through, so inline it. Complexity reappears across callers: it earns
|
|
20
|
+
its keep. A deepening concentrates complexity; it does not just move it.
|
|
21
|
+
- **Interface is the test surface.** Tests that must reach past the interface
|
|
22
|
+
mean the module has the wrong shape.
|
|
23
|
+
- **One adapter is a hypothetical seam; two are a real one.** Do not add a
|
|
24
|
+
port unless something varies across it (production and test count).
|
|
25
|
+
|
|
26
|
+
## What the explorer looks for
|
|
27
|
+
|
|
28
|
+
- One concept that needs a hop through many small modules to understand.
|
|
29
|
+
- Shallow modules: wide interface, thin implementation.
|
|
30
|
+
- Pure helpers extracted only for tests while the bugs live in how they are
|
|
31
|
+
called (no locality).
|
|
32
|
+
- Coupled modules leaking through their seams: one fix edits both (churn shows
|
|
33
|
+
them changing together).
|
|
34
|
+
- Code that is untested, or hard to test through its current interface.
|
|
35
|
+
|
|
36
|
+
The explorer is read-only (on Claude Code, the Explore agent). It reads code,
|
|
37
|
+
git history, `workit ledger list` and `workit test-audit` output only: never
|
|
38
|
+
session transcripts and never another workspace. It copies no secret, token
|
|
39
|
+
or personal data into its findings. It returns only cited findings (file,
|
|
40
|
+
commit, ledger row), never a refactor.
|
|
41
|
+
|
|
42
|
+
## Dependency categories (how the deeper module is tested)
|
|
43
|
+
|
|
44
|
+
1. In-process (pure, in-memory): merge and test through the new interface.
|
|
45
|
+
2. Local stand-in exists (temp dir, in-memory store): test with the stand-in;
|
|
46
|
+
the seam stays internal.
|
|
47
|
+
3. Owned but remote (your own service): a port at the seam, an in-memory
|
|
48
|
+
adapter in tests.
|
|
49
|
+
4. Third party: an injected port, a fake adapter in tests.
|
|
50
|
+
|
|
51
|
+
Replace, do not layer. An old test on a shallow module is deleted only after
|
|
52
|
+
naming the break it catches and showing that a test at the deeper interface
|
|
53
|
+
fails on that planted break (call the Skill tool with `workit:test-audit`). Until then it stays.
|