@ranger-testing/ranger-cli 1.0.10 → 1.0.12
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/README.md +111 -0
- package/build/cli.js +230 -8
- package/build/cli.js.map +1 -1
- package/build/commands/addEnv.js +1 -1
- package/build/commands/addEnv.js.map +1 -1
- package/build/commands/clean.js +1 -1
- package/build/commands/clean.js.map +1 -1
- package/build/commands/dataMcpServer.js +1 -1
- package/build/commands/dataMcpServer.js.map +1 -1
- package/build/commands/env.js +46 -0
- package/build/commands/env.js.map +1 -0
- package/build/commands/feature.js +494 -0
- package/build/commands/feature.js.map +1 -0
- package/build/commands/index.js +1 -0
- package/build/commands/index.js.map +1 -1
- package/build/commands/skillup.js +65 -16
- package/build/commands/skillup.js.map +1 -1
- package/build/commands/start.js +1 -1
- package/build/commands/start.js.map +1 -1
- package/build/commands/status.js +42 -11
- package/build/commands/status.js.map +1 -1
- package/build/commands/update.js +29 -16
- package/build/commands/update.js.map +1 -1
- package/build/commands/updateEnv.js +1 -1
- package/build/commands/updateEnv.js.map +1 -1
- package/build/commands/useEnv.js +1 -1
- package/build/commands/useEnv.js.map +1 -1
- package/build/commands/utils/browserSessionsApi.js +1 -1
- package/build/commands/utils/browserSessionsApi.js.map +1 -1
- package/build/commands/utils/claudeConfig.js +73 -0
- package/build/commands/utils/claudeConfig.js.map +1 -0
- package/build/commands/utils/cliSecret.js +1 -1
- package/build/commands/utils/environment.js +69 -0
- package/build/commands/utils/environment.js.map +1 -0
- package/build/commands/utils/featureApi.js +190 -0
- package/build/commands/utils/featureApi.js.map +1 -0
- package/build/commands/utils/featureReportGenerator.js +170 -0
- package/build/commands/utils/featureReportGenerator.js.map +1 -0
- package/build/commands/utils/keychain.js +1 -1
- package/build/commands/utils/localAgentInstallationsApi.js +1 -1
- package/build/commands/utils/localAgentInstallationsApi.js.map +1 -1
- package/build/commands/utils/mcpConfig.js +1 -1
- package/build/commands/utils/settings.js +2 -2
- package/build/commands/utils/settings.js.map +1 -1
- package/build/commands/utils/skills.js +1 -1
- package/build/commands/utils/skills.js.map +1 -1
- package/build/commands/verifyFeature.js +451 -0
- package/build/commands/verifyFeature.js.map +1 -0
- package/build/commands/verifyInBrowser.js +1 -1
- package/build/commands/verifyInBrowser.js.map +1 -1
- package/build/skills/feature-tracker/SKILL.md +185 -0
- package/build/skills/feature-tracker/create.md +105 -0
- package/build/skills/feature-tracker/manage.md +145 -0
- package/build/skills/feature-tracker/report.md +159 -0
- package/build/skills/feature-tracker/start.md +93 -0
- package/build/skills/feature-tracker/verify.md +143 -0
- package/package.json +23 -20
- package/build/agents/bug-basher.md +0 -259
- package/build/agents/e2e-test-recommender.md +0 -164
- package/build/agents/quality-advocate.md +0 -164
- package/build/agents/ui-verifier.md +0 -100
- package/build/commands/addApp.js +0 -21
- package/build/commands/initAgents.js +0 -84
- package/build/commands/utils/agents.js +0 -45
- package/build/index.js +0 -436
- package/build/test-auth.js +0 -13
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"verifyInBrowser.js","sourceRoot":"","sources":["../../src/commands/verifyInBrowser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EACH,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,gBAAgB,GAEnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,GACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAoB/C;;GAEG;AACH,KAAK,UAAU,YAAY,CAAC,OAAe;IACvC,wCAAwC;IACxC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAC3D,QAAQ,CAAC,OAAO,OAAO,gBAAgB,UAAU,KAAK,EAAE;QACpD,KAAK,EAAE,MAAM;KAChB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC1C,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,UAAU,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,SAAiB;IACxC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,SAAS,uBAAuB,CAAC,SAAiB;IAC9C,OAAO,IAAI,CACP,MAAM,EAAE,EACR,yBAAyB,EACzB,SAAS,EACT,oBAAoB,CACvB,CAAC;AACN,CAAC;
|
|
1
|
+
{"version":3,"file":"verifyInBrowser.js","sourceRoot":"","sources":["../../src/commands/verifyInBrowser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EACH,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,gBAAgB,GAEnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,GACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAoB/C;;GAEG;AACH,KAAK,UAAU,YAAY,CAAC,OAAe;IACvC,wCAAwC;IACxC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAC3D,QAAQ,CAAC,OAAO,OAAO,gBAAgB,UAAU,KAAK,EAAE;QACpD,KAAK,EAAE,MAAM;KAChB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC1C,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,UAAU,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,SAAiB;IACxC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,SAAS,uBAAuB,CAAC,SAAiB;IAC9C,OAAO,IAAI,CACP,MAAM,EAAE,EACR,yBAAyB,EACzB,SAAS,EACT,oBAAoB,CACvB,CAAC;AACN,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,IAAY,EACZ,UAAkC,EAAE;IAEpC,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAExC,wCAAwC;IACxC,IAAI,SAAiB,CAAC;IACtB,IAAI,GAAG,EAAE,CAAC;QACN,SAAS,GAAG,GAAG,CAAC;IACpB,CAAC;SAAM,CAAC;QACJ,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;QACvE,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACX,mDAAmD,CACtD,CAAC;QACN,CAAC;QACD,SAAS,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1D,CAAC,CAAC,IAAI,EAAE,CACX,CAAC;IACN,CAAC;IAED,+CAA+C;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACX,4BAA4B,MAAM,yBAAyB,SAAS,EAAE,CACzE,CAAC;IACN,CAAC;IAED,oCAAoC;IACpC,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC,CAAC;IAE/C,4CAA4C;IAC5C,MAAM,gBAAgB,GAAG,cAAc,CAAC,QAAQ,CAAa,CAAC;IAE9D,6BAA6B;IAC7B,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC;IACrC,IAAI,CAAC,GAAG,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CACX,0CAA0C,SAAS,6BAA6B,SAAS,gBAAgB,CAC5G,CAAC;IACN,CAAC;IAED,6CAA6C;IAC7C,iFAAiF;IACjF,MAAM,KAAK,GAAG,MAAM,QAAQ,EAAE,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,oBAAoB,CAAC;QAC9C,eAAe,EAAE,SAAS;QAC1B,QAAQ,EAAE,gBAA2C;QACrD,IAAI;QACJ,GAAG;KACN,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,4BAA4B,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;IAE7D,6EAA6E;IAC7E,MAAM,YAAY,GAAG,MAAM,qBAAqB,CAC5C,gBAAgB,EAChB,SAAS,EACT,cAAc,EAAE,EAAE,EAClB,MAAM,CACT,CAAC;IAEF,MAAM,gBAAgB,GAAG;QACrB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE;YACF,4BAA4B;YAC5B,gBAAgB;YAChB,UAAU;YACV,YAAY,CAAC,UAAU;SAC1B;KACJ,CAAC;IAEF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,0CAA0C;IAC1C,IAAI,eAAuB,CAAC;IAC5B,IAAI,CAAC;QACD,eAAe,GAAG,MAAM,kBAAkB,EAAE,CAAC;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,QAAQ,GAAG,sDAAsD,OAAO,EAAE,CAAC;QAEjF,4CAA4C;QAC5C,IAAI,CAAC;YACD,MAAM,oBAAoB,CAAC,cAAc,CAAC,EAAE,EAAE;gBAC1C,MAAM,EAAE,QAAQ;gBAChB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAClC,YAAY,EAAE,QAAQ;aACzB,CAAC,CAAC;QACP,CAAC;QAAC,MAAM,CAAC;YACL,yBAAyB;QAC7B,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,+BAA+B;IAC/B,MAAM,gBAAgB,GAAG;;;oBAGT,GAAG;;;;;;;;;;;;;;;aAeV,IAAI;OACV,GAAG,EAAE,CAAC;IAET,iDAAiD;IACjD,MAAM,YAAY,GAAG;QACjB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACR,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YAC5B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC3B,MAAM,EAAE;gBACJ,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACR,QAAQ,EAAE;4BACN,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC;yBACtC;wBACD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBAC/B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;qBACjC;oBACD,QAAQ,EAAE,CAAC,UAAU,EAAE,aAAa,CAAC;iBACxC;aACJ;YACD,WAAW,EAAE;gBACT,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC5B;SACJ;QACD,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;KACnC,CAAC;IAEF,0CAA0C;IAC1C,MAAM,MAAM,GAAG,KAAK,CAAC;QACjB,MAAM,EAAE,gBAAgB;QACxB,OAAO,EAAE;YACL,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,KAAK,EAAE,iBAAiB,EAAE,4DAA4D;YACtF,UAAU,EAAE;gBACR,gBAAgB,EAAE,gBAAgB;aACrC;YACD,KAAK,EAAE,CAAC,wBAAwB,CAAC,EAAE,oCAAoC;YACvE,cAAc,EAAE,mBAAmB,EAAE,sBAAsB;YAC3D,+BAA+B,EAAE,IAAI;YACrC,YAAY,EAAE;gBACV,IAAI,EAAE,aAAa;gBACnB,MAAM,EAAE,YAAY;aACvB;YACD,GAAG,EAAE;gBACD,GAAG,OAAO,CAAC,GAAG;gBACd,iBAAiB,EAAE,eAAe;aACrC;YACD,cAAc,EAAE,KAAK;SACxB;KACJ,CAAC,CAAC;IAEH,sDAAsD;IACtD,IAAI,WAAW,GAA8B,IAAI,CAAC;IAClD,IAAI,UAAU,GAAkB,IAAI,CAAC;IAErC,4DAA4D;IAC5D,MAAM,oBAAoB,GAAG,uBAAuB,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;IACxE,MAAM,eAAe,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACtD,MAAM,KAAK,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAElD,kEAAkE;IAClE,MAAM,UAAU,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;IAChD,MAAM,cAAc,GAAG,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QACnD,UAAU,CAAC,GAAG,EAAE;YACZ,MAAM,CAAC,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC,CAAC;QACpE,CAAC,EAAE,UAAU,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACD,IAAI,CAAC;YACD,2CAA2C;YAC3C,MAAM,OAAO,CAAC,IAAI,CAAC;gBACf,CAAC,KAAK,IAAI,EAAE;oBACR,IAAI,KAAK,EAAE,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;wBACjC,uDAAuD;wBACvD,IAAI,CAAC;4BACD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;4BAChD,MAAM,UAAU,CACZ,oBAAoB,EACpB,QAAQ,EACR,OAAO,CACV,CAAC;wBACN,CAAC;wBAAC,MAAM,CAAC;4BACL,8CAA8C;wBAClD,CAAC;wBAED,MAAM,GAAG,GAAG,OAAc,CAAC;wBAE3B,mDAAmD;wBACnD,uGAAuG;wBACvG,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;4BACZ,IAAI,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC;4BAE1B,mDAAmD;4BACnD,IACI,GAAG,CAAC,OAAO,EAAE,OAAO;gCACpB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,EACpC,CAAC;gCACC,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO;qCAC5B,MAAM,CACH,CAAC,CAAmB,EAAE,EAAE,CACpB,CAAC,CAAC,IAAI,KAAK,MAAM,CACxB;qCACA,GAAG,CAAC,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;qCACpC,MAAM,CAAC,OAAO,CAAC,CAAC;gCACrB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oCACnB,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gCAChC,CAAC;4BACL,CAAC;4BAED,UAAU,GAAG,SAAS,CAAC;wBAC3B,CAAC;wBAED,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;4BAC5B,IACI,OAAO,CAAC,OAAO,KAAK,SAAS;gCAC7B,OAAO,CAAC,iBAAiB,EAC3B,CAAC;gCACC,WAAW;oCACP,OAAO,CAAC,iBAAuC,CAAC;4BACxD,CAAC;iCAAM,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gCACvC,iEAAiE;gCACjE,IAAI,CAAC,UAAU,EAAE,CAAC;oCACd,UAAU;wCACN,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC;4CAC1B,eAAe,CAAC;gCACxB,CAAC;4BACL,CAAC;wBACL,CAAC;oBACL,CAAC;gBACL,CAAC,CAAC,EAAE;gBACJ,cAAc;aACjB,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,UAAU,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAE1C,wEAAwE;QACxE,IAAI,gBAAoC,CAAC;QACzC,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;YACtD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACtC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACnB,gCAAgC;oBAChC,MAAM,SAAS,GAAG,MAAM,aAAa,CACjC,cAAc,CAAC,EAAE,EACjB,WAAW,EACX,KAAK,CACR,CAAC;oBACF,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;oBACjD,MAAM,WAAW,CAAC,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;oBACpD,gBAAgB,GAAG,SAAS,CAAC,WAAW,CAAC;oBAEzC,oCAAoC;oBACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAChC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CACnC,CAAC;oBACF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;wBAC7B,IAAI,CAAC;4BACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;4BACxC,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;4BAC1C,MAAM,OAAO,GAAG,MAAM,aAAa,CAC/B,cAAc,CAAC,EAAE,EACjB,OAAO,EACP,KAAK,CACR,CAAC;4BACF,MAAM,gBAAgB,CAClB,OAAO,CAAC,SAAS,EACjB,SAAS,CACZ,CAAC;wBACN,CAAC;wBAAC,MAAM,CAAC;4BACL,wDAAwD;wBAC5D,CAAC;oBACL,CAAC;gBACL,CAAC;YACL,CAAC;YAED,wCAAwC;YACxC,IAAI,UAAU,CAAC,oBAAoB,CAAC,EAAE,CAAC;gBACnC,IAAI,CAAC;oBACD,yCAAyC;oBACzC,MAAM,gBAAgB,GAAG,MAAM,aAAa,CACxC,cAAc,CAAC,EAAE,EACjB,oBAAoB,EACpB,OAAO,CACV,CAAC;oBACF,MAAM,kBAAkB,GACpB,MAAM,QAAQ,CAAC,oBAAoB,CAAC,CAAC;oBACzC,MAAM,kBAAkB,CACpB,gBAAgB,CAAC,SAAS,EAC1B,kBAAkB,CACrB,CAAC;gBACN,CAAC;gBAAC,MAAM,CAAC;oBACL,+CAA+C;gBACnD,CAAC;YACL,CAAC;YAED,wBAAwB;YACxB,6DAA6D;YAC7D,MAAM,MAAM,GAAG,WAAwC,CAAC;YACxD,MAAM,UAAU,GAAG;gBACf,MAAM,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAE9B;gBACd,UAAU;gBACV,aAAa,EAAE,MAAM,EAAE,OAAO,IAAI,UAAU,IAAI,SAAS;gBACzD,YAAY,EAAE,UAAU,IAAI,SAAS;aACxC,CAAC;YAEF,MAAM,oBAAoB,CAAC,cAAc,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;YAE1D,8DAA8D;YAC9D,IAAI,MAAM,IAAI,gBAAgB,EAAE,CAAC;gBAC7B,MAAM,CAAC,cAAc,GAAG,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;gBAC9D,MAAM,CAAC,SAAS,GAAG,cAAc,CAAC,EAAE,CAAC;gBACrC,MAAM,CAAC,UAAU,GAAG,iBAAiB,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;gBACzD,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;gBAC/B,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;gBACnB,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC;YACrB,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACL,wCAAwC;QAC5C,CAAC;QAED,IAAI,UAAU,IAAI,CAAC,WAAW,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,wBAAwB,UAAU,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACrD,CAAC;QAED,OAAO,WAAW,CAAC;IACvB,CAAC;YAAS,CAAC;QACP,yDAAyD;QACzD,MAAM,gBAAgB,CAAC,YAAY,CAAC,CAAC;QAErC,qCAAqC;QACrC,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;YACtD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvB,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACzD,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACL,mCAAmC;QACvC,CAAC;QAED,8CAA8C;QAC9C,IAAI,CAAC;YACD,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;gBAC9B,MAAM,EAAE,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAChE,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACL,mCAAmC;QACvC,CAAC;IACL,CAAC;AACL,CAAC"}
|
|
@@ -0,0 +1,185 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: feature-tracker
|
|
3
|
+
description: "Core development workflow for building e2e features. Use this skill for ANY feature development, implementation, or code changes that touches UI. Automatically tracks progress with checklist items, verifies implementations in the browser, and generates completion reports with evidence. Start every coding task by checking for existing features to resume."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
You are a Feature Development Agent. Your job is to systematically implement features while tracking progress with verifiable checklist items. Every implementation gets verified in the browser with evidence (screenshots, traces, conversation logs).
|
|
7
|
+
|
|
8
|
+
# When to Use This Skill
|
|
9
|
+
|
|
10
|
+
Use this skill for ANY substantial feature work:
|
|
11
|
+
- Building new features
|
|
12
|
+
- Multi-step development tasks
|
|
13
|
+
- Code changes that should be verified
|
|
14
|
+
- Continuing previous feature work
|
|
15
|
+
|
|
16
|
+
# Workflow Overview
|
|
17
|
+
|
|
18
|
+
```
|
|
19
|
+
┌───────────────────────────────────────┐
|
|
20
|
+
│ 1. RESUME OR CREATE FEATURE │ ◀── Skill: start.md, create.md
|
|
21
|
+
│ • Resume existing feature │
|
|
22
|
+
│ • OR create new feature │
|
|
23
|
+
└───────────────────┬───────────────────┘
|
|
24
|
+
│
|
|
25
|
+
▼
|
|
26
|
+
┌───────────────────────┐
|
|
27
|
+
│ │
|
|
28
|
+
│ ┌───────────────┐ │
|
|
29
|
+
│ │ 2. IMPLEMENT │ │ ◀── You write code (not covered by skill)
|
|
30
|
+
│ │ in code │ │
|
|
31
|
+
│ └───────┬───────┘ │
|
|
32
|
+
│ │ │
|
|
33
|
+
│ ▼ │
|
|
34
|
+
│ ┌───────────────┐ │
|
|
35
|
+
│ │ 3. VERIFY │ │ ◀── Skill: verify.md (+ manage.md for scope changes)
|
|
36
|
+
│ │ in browser │ │
|
|
37
|
+
│ └───────┬───────┘ │
|
|
38
|
+
│ │ │
|
|
39
|
+
│ ▼ │
|
|
40
|
+
│ More items? │
|
|
41
|
+
│ YES ─┘ │
|
|
42
|
+
│ │
|
|
43
|
+
└───────────┬───────────┘
|
|
44
|
+
│ NO (all verified)
|
|
45
|
+
▼
|
|
46
|
+
┌───────────────────────────────────────┐
|
|
47
|
+
│ 4. REPORT │ ◀── Skill: report.md
|
|
48
|
+
│ • Generate completion report │
|
|
49
|
+
│ • Share with user │
|
|
50
|
+
└───────────────────────────────────────┘
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
# Step 1: Resume or Create Feature
|
|
56
|
+
|
|
57
|
+
**Goal:** Have an active feature with a checklist before you start coding.
|
|
58
|
+
|
|
59
|
+
### Resume Existing Feature
|
|
60
|
+
|
|
61
|
+
Check if there's a feature to resume from the current git context:
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
ranger feature resume
|
|
65
|
+
ranger feature show
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
See [start.md](./start.md) for details on resuming features.
|
|
69
|
+
|
|
70
|
+
### Create New Feature
|
|
71
|
+
|
|
72
|
+
If no existing feature, create one with a detailed checklist:
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
ranger feature create "Feature Name" \
|
|
76
|
+
--description "Comprehensive description of what this feature does" \
|
|
77
|
+
--checklist "Detailed item 1,Detailed item 2,Detailed item 3"
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
See [create.md](./create.md) for details on writing good descriptions.
|
|
81
|
+
|
|
82
|
+
### Manage Checklist
|
|
83
|
+
|
|
84
|
+
Add, edit, or update checklist items as scope evolves:
|
|
85
|
+
|
|
86
|
+
```bash
|
|
87
|
+
ranger feature manage --add "New item"
|
|
88
|
+
ranger feature manage --edit 1 --description "Updated description"
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
See [manage.md](./manage.md) for all checklist management commands.
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
# Step 2: Implement in Code
|
|
96
|
+
|
|
97
|
+
**Goal:** Write the code for a checklist item.
|
|
98
|
+
|
|
99
|
+
This step is your normal coding work - not covered by this skill. Write the implementation for one or more checklist items.
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
# Step 3: Verify in Browser
|
|
104
|
+
|
|
105
|
+
**Goal:** Verify each implementation works and capture evidence.
|
|
106
|
+
|
|
107
|
+
After implementing, verify in the browser:
|
|
108
|
+
|
|
109
|
+
```bash
|
|
110
|
+
ranger verify-feature \
|
|
111
|
+
--url "http://localhost:3000" \
|
|
112
|
+
--task "Detailed description of what to verify"
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
The verification agent will:
|
|
116
|
+
1. Execute the task in a real browser
|
|
117
|
+
2. Evaluate if the checklist item is satisfied
|
|
118
|
+
3. Mark the item as verified, partial, blocked, or failed
|
|
119
|
+
4. Link the session evidence (trace, screenshots)
|
|
120
|
+
|
|
121
|
+
See [verify.md](./verify.md) for details on writing good verification tasks.
|
|
122
|
+
|
|
123
|
+
### Repeat
|
|
124
|
+
|
|
125
|
+
Continue the **Implement → Verify** cycle for each checklist item until all are verified.
|
|
126
|
+
|
|
127
|
+
### Scope Changes
|
|
128
|
+
|
|
129
|
+
If the feature scope changes during implementation (new requirements, items no longer needed, etc.), update the checklist:
|
|
130
|
+
|
|
131
|
+
```bash
|
|
132
|
+
ranger feature manage --add "New requirement discovered"
|
|
133
|
+
ranger feature manage --cancel 3 --reason "No longer needed per PM"
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
See [manage.md](./manage.md) for all checklist management commands.
|
|
137
|
+
|
|
138
|
+
---
|
|
139
|
+
|
|
140
|
+
# Step 4: Report
|
|
141
|
+
|
|
142
|
+
**Goal:** Generate a completion report with all evidence.
|
|
143
|
+
|
|
144
|
+
When all items are verified (feature auto-completes), generate a report:
|
|
145
|
+
|
|
146
|
+
```bash
|
|
147
|
+
ranger feature report
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
Share the report with the user:
|
|
151
|
+
|
|
152
|
+
> Feature complete! All checklist items verified.
|
|
153
|
+
> **Report:** [.ranger/reports/feat_abc123.md](.ranger/reports/feat_abc123.md)
|
|
154
|
+
|
|
155
|
+
See [report.md](./report.md) for report contents and sharing.
|
|
156
|
+
|
|
157
|
+
---
|
|
158
|
+
|
|
159
|
+
# Quick Reference
|
|
160
|
+
|
|
161
|
+
| Command | Purpose |
|
|
162
|
+
|---------|---------|
|
|
163
|
+
| `ranger feature resume` | Find & resume feature by git context |
|
|
164
|
+
| `ranger feature show` | Show current feature status |
|
|
165
|
+
| `ranger feature create` | Create new feature with checklist |
|
|
166
|
+
| `ranger feature manage` | Add/edit/block/cancel checklist items |
|
|
167
|
+
| `ranger verify-feature` | Verify item in browser |
|
|
168
|
+
| `ranger feature report` | Generate completion report |
|
|
169
|
+
|
|
170
|
+
# Skill Files
|
|
171
|
+
|
|
172
|
+
| File | Covers |
|
|
173
|
+
|------|--------|
|
|
174
|
+
| [start.md](./start.md) | Resuming features, listing features, git context |
|
|
175
|
+
| [create.md](./create.md) | Creating features, writing good descriptions |
|
|
176
|
+
| [manage.md](./manage.md) | All checklist item operations |
|
|
177
|
+
| [verify.md](./verify.md) | Browser verification, evaluation results |
|
|
178
|
+
| [report.md](./report.md) | Generating and sharing reports |
|
|
179
|
+
|
|
180
|
+
# Key Principles
|
|
181
|
+
|
|
182
|
+
1. **Always check for existing features first** - Run `ranger feature resume` at session start
|
|
183
|
+
2. **Be very descriptive** - Detailed descriptions help verification agents evaluate results
|
|
184
|
+
3. **Verify after implementing** - Don't skip browser verification
|
|
185
|
+
4. **Generate reports** - Provide evidence of completion to users
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
# Creating a New Feature
|
|
2
|
+
|
|
3
|
+
Create a feature when starting new work that doesn't have an existing feature to resume.
|
|
4
|
+
|
|
5
|
+
## Basic Command
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
ranger feature create "<feature name>" \
|
|
9
|
+
--description "<comprehensive description>" \
|
|
10
|
+
--checklist "<item 1>,<item 2>,<item 3>"
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## What Gets Captured Automatically
|
|
14
|
+
|
|
15
|
+
When you create a feature, the CLI automatically captures:
|
|
16
|
+
- **Git repo URL** - From `git remote get-url origin`
|
|
17
|
+
- **Git branch** - From current branch name
|
|
18
|
+
- **Created timestamp**
|
|
19
|
+
- **Your organization** - From API token
|
|
20
|
+
|
|
21
|
+
This enables `ranger feature resume` to find features by git context later.
|
|
22
|
+
|
|
23
|
+
## Writing Good Descriptions
|
|
24
|
+
|
|
25
|
+
**The key to good feature tracking is DETAILED DESCRIPTIONS.**
|
|
26
|
+
|
|
27
|
+
### Feature Names
|
|
28
|
+
|
|
29
|
+
Should be clear and specific:
|
|
30
|
+
|
|
31
|
+
| Bad | Good |
|
|
32
|
+
|-----|------|
|
|
33
|
+
| "User auth" | "User Authentication System" |
|
|
34
|
+
| "Fix bug" | "Fix Payment Processing Timeout" |
|
|
35
|
+
| "New feature" | "Dashboard Analytics Widget" |
|
|
36
|
+
|
|
37
|
+
### Feature Descriptions
|
|
38
|
+
|
|
39
|
+
Should explain the full scope and goals:
|
|
40
|
+
|
|
41
|
+
**Bad:**
|
|
42
|
+
```
|
|
43
|
+
Login, signup, password reset
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
**Good:**
|
|
47
|
+
```
|
|
48
|
+
Complete user authentication system for the web app. Includes:
|
|
49
|
+
- Secure login with email/password
|
|
50
|
+
- New user signup with email verification
|
|
51
|
+
- Password reset flow with secure tokens
|
|
52
|
+
All forms should have proper validation, loading states, and error handling.
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
### Checklist Items
|
|
56
|
+
|
|
57
|
+
Should explain what success looks like - these descriptions become the default task for browser verification:
|
|
58
|
+
|
|
59
|
+
**Bad:**
|
|
60
|
+
```
|
|
61
|
+
Login works
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
**Good:**
|
|
65
|
+
```
|
|
66
|
+
User can log in with valid email and password - sees loading state during submission - redirects to dashboard on success - sees appropriate error message for invalid credentials
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
## Complete Example
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
ranger feature create "User Authentication" \
|
|
73
|
+
--description "Complete user authentication system for the web app. Includes secure login with email/password, new user signup with email verification, and password reset flow. All forms should have proper validation, loading states, and error handling." \
|
|
74
|
+
--checklist "User can log in with valid email and password - sees loading state during submission - redirects to dashboard on success - sees appropriate error message for invalid credentials,User can sign up with email and password - receives verification email - can verify email via link - account is created and user is logged in,User can request password reset - receives reset email with secure link - can set new password - can log in with new password"
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
## Output
|
|
78
|
+
|
|
79
|
+
```
|
|
80
|
+
Creating feature...
|
|
81
|
+
|
|
82
|
+
✅ Feature created: feat_01abc123
|
|
83
|
+
|
|
84
|
+
🔄 User Authentication (feat_01abc123)
|
|
85
|
+
Status: in_progress
|
|
86
|
+
Description: Complete user authentication system...
|
|
87
|
+
Repository: github.com/myorg/myapp
|
|
88
|
+
Branch: feature/auth
|
|
89
|
+
Created: 1/21/2026, 10:30:00 AM
|
|
90
|
+
|
|
91
|
+
Checklist:
|
|
92
|
+
1. ⬜ User can log in with valid email and password...
|
|
93
|
+
2. ⬜ User can sign up with email and password...
|
|
94
|
+
3. ⬜ User can request password reset...
|
|
95
|
+
|
|
96
|
+
➡️ Set as active feature
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
## After Creation
|
|
100
|
+
|
|
101
|
+
The new feature is automatically set as the active feature. You can now:
|
|
102
|
+
|
|
103
|
+
1. Start implementing the first checklist item
|
|
104
|
+
2. Add more items with `ranger feature manage --add "..."`
|
|
105
|
+
3. View status with `ranger feature show`
|
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
# Managing Checklist Items
|
|
2
|
+
|
|
3
|
+
Manage checklist items as you work through a feature. The `manage` command supports both interactive mode (for humans) and CLI flags (for agents/automation).
|
|
4
|
+
|
|
5
|
+
## Quick Reference
|
|
6
|
+
|
|
7
|
+
| Action | Command |
|
|
8
|
+
|--------|---------|
|
|
9
|
+
| Add item | `ranger feature manage --add "description"` |
|
|
10
|
+
| Edit item | `ranger feature manage --edit <index> --description "new text"` |
|
|
11
|
+
| Block item | `ranger feature manage --block <index> --reason "why"` |
|
|
12
|
+
| Cancel item | `ranger feature manage --cancel <index> --reason "why"` |
|
|
13
|
+
| Reset to pending | `ranger feature manage --reset <index>` |
|
|
14
|
+
|
|
15
|
+
**Note:** All indexes are 1-based (first item is 1, not 0).
|
|
16
|
+
|
|
17
|
+
## Adding Items
|
|
18
|
+
|
|
19
|
+
Add new checklist items as scope expands or you discover new requirements:
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
ranger feature manage --add "New item that needs to be done"
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
**Tip:** Be descriptive! The item description becomes the default task for browser verification.
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
# Bad
|
|
29
|
+
ranger feature manage --add "Test logout"
|
|
30
|
+
|
|
31
|
+
# Good
|
|
32
|
+
ranger feature manage --add "User can click logout button in header - sees confirmation - is redirected to login page - session is invalidated"
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
## Editing Items
|
|
36
|
+
|
|
37
|
+
Update an item's description to clarify requirements or fix typos:
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
ranger feature manage --edit 1 --description "Updated description with more detail"
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
Use `ranger feature show` first to see item indexes:
|
|
44
|
+
|
|
45
|
+
```
|
|
46
|
+
Checklist:
|
|
47
|
+
1. ⬜ First item <-- index 1
|
|
48
|
+
2. ⬜ Second item <-- index 2
|
|
49
|
+
3. ⬜ Third item <-- index 3
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
## Blocking Items
|
|
53
|
+
|
|
54
|
+
Mark an item as blocked when something prevents completion:
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
ranger feature manage --block 2 --reason "API endpoint not implemented yet"
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
Common blocking reasons:
|
|
61
|
+
- Bug in dependent system
|
|
62
|
+
- Missing API endpoint
|
|
63
|
+
- Waiting for design assets
|
|
64
|
+
- Environment issue
|
|
65
|
+
|
|
66
|
+
## Canceling Items
|
|
67
|
+
|
|
68
|
+
Cancel items that are no longer needed:
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
ranger feature manage --cancel 3 --reason "Descoped to v2 based on PM feedback"
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
Canceled items:
|
|
75
|
+
- Don't count toward completion
|
|
76
|
+
- Are shown with strikethrough in reports
|
|
77
|
+
- Preserve the cancellation reason for context
|
|
78
|
+
|
|
79
|
+
## Resetting Items
|
|
80
|
+
|
|
81
|
+
Reset a blocked or canceled item back to pending:
|
|
82
|
+
|
|
83
|
+
```bash
|
|
84
|
+
ranger feature manage --reset 2
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
Use this when:
|
|
88
|
+
- A blocker is resolved
|
|
89
|
+
- A canceled item is back in scope
|
|
90
|
+
- You need to re-verify a previously verified item
|
|
91
|
+
|
|
92
|
+
## Interactive Mode
|
|
93
|
+
|
|
94
|
+
For humans, run without flags to get an interactive menu:
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
ranger feature manage
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
This shows:
|
|
101
|
+
```
|
|
102
|
+
Managing: User Authentication (feat_abc123)
|
|
103
|
+
|
|
104
|
+
Current checklist:
|
|
105
|
+
1. ✅ Login flow works
|
|
106
|
+
2. ⬜ Signup creates account
|
|
107
|
+
3. 🛑 Password reset sends email
|
|
108
|
+
Blocked: Email service not configured
|
|
109
|
+
|
|
110
|
+
? What would you like to do?
|
|
111
|
+
❯ Add new item
|
|
112
|
+
Update existing item
|
|
113
|
+
Cancel
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
## Item Statuses
|
|
117
|
+
|
|
118
|
+
| Status | Emoji | Meaning |
|
|
119
|
+
|--------|-------|---------|
|
|
120
|
+
| Pending | ⬜ | Not yet verified |
|
|
121
|
+
| Verified | ✅ | Successfully verified in browser |
|
|
122
|
+
| Blocked | 🛑 | Cannot complete due to blocker |
|
|
123
|
+
| Canceled | ⛔ | No longer needed |
|
|
124
|
+
|
|
125
|
+
## Workflow Example
|
|
126
|
+
|
|
127
|
+
```bash
|
|
128
|
+
# Check current state
|
|
129
|
+
ranger feature show
|
|
130
|
+
|
|
131
|
+
# Add a new requirement discovered during implementation
|
|
132
|
+
ranger feature manage --add "Form should show inline validation errors"
|
|
133
|
+
|
|
134
|
+
# Realize an item needs clarification
|
|
135
|
+
ranger feature manage --edit 2 --description "Signup form validates email format and password strength before submission"
|
|
136
|
+
|
|
137
|
+
# Hit a blocker
|
|
138
|
+
ranger feature manage --block 3 --reason "SMTP server not configured in local env"
|
|
139
|
+
|
|
140
|
+
# Blocker resolved later
|
|
141
|
+
ranger feature manage --reset 3
|
|
142
|
+
|
|
143
|
+
# Scope change from PM
|
|
144
|
+
ranger feature manage --cancel 4 --reason "Social login moved to v2"
|
|
145
|
+
```
|
|
@@ -0,0 +1,159 @@
|
|
|
1
|
+
# Generating Reports
|
|
2
|
+
|
|
3
|
+
When a feature is complete (or you need a status update), generate a report with all verification evidence.
|
|
4
|
+
|
|
5
|
+
## Basic Command
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
ranger feature report
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
This creates a markdown file at `.ranger/reports/<feature-id>.md`
|
|
12
|
+
|
|
13
|
+
## Options
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
# Report for active feature
|
|
17
|
+
ranger feature report
|
|
18
|
+
|
|
19
|
+
# Report for specific feature
|
|
20
|
+
ranger feature report feat_abc123
|
|
21
|
+
|
|
22
|
+
# Custom output path
|
|
23
|
+
ranger feature report --output ./my-report.md
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## When to Generate Reports
|
|
27
|
+
|
|
28
|
+
1. **Feature complete** - All items verified, share with stakeholders
|
|
29
|
+
2. **Progress update** - Show what's done and what's remaining
|
|
30
|
+
3. **Blocked status** - Document what's blocking and what evidence exists
|
|
31
|
+
4. **Handoff** - Another developer taking over the feature
|
|
32
|
+
|
|
33
|
+
## Report Contents
|
|
34
|
+
|
|
35
|
+
The generated report includes:
|
|
36
|
+
|
|
37
|
+
### Header
|
|
38
|
+
- Feature name and ID
|
|
39
|
+
- Current status (in_progress, completed, blocked)
|
|
40
|
+
- Git context (repo, branch)
|
|
41
|
+
- Created/completed dates
|
|
42
|
+
|
|
43
|
+
### Description
|
|
44
|
+
- Full feature description
|
|
45
|
+
|
|
46
|
+
### Checklist Progress
|
|
47
|
+
- Each item with status emoji
|
|
48
|
+
- Verification details (date, session ID)
|
|
49
|
+
- Agent summary of what was verified
|
|
50
|
+
- Links to Playwright traces
|
|
51
|
+
- Blocked/canceled reasons
|
|
52
|
+
|
|
53
|
+
### Blocking Issues
|
|
54
|
+
- Summary of any blocked items
|
|
55
|
+
- Reasons and context
|
|
56
|
+
|
|
57
|
+
### Verification Sessions
|
|
58
|
+
- Table of all browser sessions
|
|
59
|
+
- Item, status, duration, date
|
|
60
|
+
|
|
61
|
+
## Example Report
|
|
62
|
+
|
|
63
|
+
```markdown
|
|
64
|
+
# Feature Report: User Authentication
|
|
65
|
+
|
|
66
|
+
**Status:** ✅ Completed
|
|
67
|
+
**Created:** Jan 20, 2026
|
|
68
|
+
**Completed:** Jan 21, 2026
|
|
69
|
+
**Repository:** github.com/myorg/myapp
|
|
70
|
+
**Branch:** feature/auth
|
|
71
|
+
|
|
72
|
+
## Description
|
|
73
|
+
|
|
74
|
+
Complete user authentication system including login, signup, and password reset.
|
|
75
|
+
|
|
76
|
+
## Checklist Progress (3/3 verified)
|
|
77
|
+
|
|
78
|
+
### ✅ User can log in with valid credentials
|
|
79
|
+
|
|
80
|
+
- **Verified:** Jan 20, 2026
|
|
81
|
+
- **Session:** bsess_abc123
|
|
82
|
+
- **Summary:** Successfully logged in with test credentials, verified redirect to dashboard
|
|
83
|
+
- **Trace:** [View in Playwright](https://trace.playwright.dev/?trace=...)
|
|
84
|
+
|
|
85
|
+
### ✅ User can sign up with new account
|
|
86
|
+
|
|
87
|
+
- **Verified:** Jan 21, 2026
|
|
88
|
+
- **Session:** bsess_def456
|
|
89
|
+
- **Summary:** Created new account, verified welcome email received
|
|
90
|
+
- **Trace:** [View in Playwright](https://trace.playwright.dev/?trace=...)
|
|
91
|
+
|
|
92
|
+
### ✅ User can reset password
|
|
93
|
+
|
|
94
|
+
- **Verified:** Jan 21, 2026
|
|
95
|
+
- **Session:** bsess_ghi789
|
|
96
|
+
- **Summary:** Completed password reset flow, verified new password works
|
|
97
|
+
- **Trace:** [View in Playwright](https://trace.playwright.dev/?trace=...)
|
|
98
|
+
|
|
99
|
+
## Blocking Issues
|
|
100
|
+
|
|
101
|
+
None
|
|
102
|
+
|
|
103
|
+
## All Verification Sessions
|
|
104
|
+
|
|
105
|
+
| Session | Item | Status | Duration | Date |
|
|
106
|
+
|---------|------|--------|----------|------|
|
|
107
|
+
| bsess_abc123 | Login | ✅ completed | 45s | Jan 20, 2026 |
|
|
108
|
+
| bsess_def456 | Signup | ✅ completed | 62s | Jan 21, 2026 |
|
|
109
|
+
| bsess_ghi789 | Reset | ✅ completed | 38s | Jan 21, 2026 |
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
## Sharing with Users
|
|
113
|
+
|
|
114
|
+
After generating a report, share it with the user:
|
|
115
|
+
|
|
116
|
+
```
|
|
117
|
+
Feature complete! All 3 checklist items verified.
|
|
118
|
+
|
|
119
|
+
**Report:** [.ranger/reports/feat_abc123.md](.ranger/reports/feat_abc123.md)
|
|
120
|
+
|
|
121
|
+
Summary:
|
|
122
|
+
- ✅ Login flow - working correctly
|
|
123
|
+
- ✅ Signup flow - creates account and sends verification email
|
|
124
|
+
- ✅ Password reset - full flow working
|
|
125
|
+
|
|
126
|
+
Each item has a Playwright trace link for detailed session replay.
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
## Playwright Traces
|
|
130
|
+
|
|
131
|
+
Each verification session records a Playwright trace. Click the trace link to:
|
|
132
|
+
- See every browser action
|
|
133
|
+
- View screenshots at each step
|
|
134
|
+
- Inspect network requests
|
|
135
|
+
- Debug any issues
|
|
136
|
+
|
|
137
|
+
Traces are hosted and accessible via the link in the report.
|
|
138
|
+
|
|
139
|
+
## Partial Reports
|
|
140
|
+
|
|
141
|
+
You can generate reports even when a feature isn't complete:
|
|
142
|
+
|
|
143
|
+
```bash
|
|
144
|
+
$ ranger feature report
|
|
145
|
+
|
|
146
|
+
Generating report...
|
|
147
|
+
✅ Report generated: .ranger/reports/feat_abc123.md
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
The report will show:
|
|
151
|
+
- Which items are verified
|
|
152
|
+
- Which are pending
|
|
153
|
+
- Which are blocked (with reasons)
|
|
154
|
+
- Progress percentage
|
|
155
|
+
|
|
156
|
+
This is useful for:
|
|
157
|
+
- Status updates to stakeholders
|
|
158
|
+
- Documenting progress before a break
|
|
159
|
+
- Showing what's blocking completion
|