Skip to content

Add requirements tracking option#1744

Open
konard wants to merge 5 commits into
mainfrom
issue-1743-df64c32eba77
Open

Add requirements tracking option#1744
konard wants to merge 5 commits into
mainfrom
issue-1743-df64c32eba77

Conversation

@konard

@konard konard commented May 2, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Add experimental --requirements-tracking, disabled by default, with documentation in docs/CONFIGURATION.md and translated configuration docs.
  • Add requirements-tracking prompt guidance for all supported solve tools: claude, codex, gemini, qwen, opencode, and agent.
  • Add PR verification that checks docs/requirements/*.md changed when requirements tracking is enabled and auto-restarts once with focused feedback if not.
  • Add the initial requirements ledger in docs/requirements/README.md, the issue 1743 case study under docs/case-studies/issue-1743/, and a minor Changesets entry.

Tests

  • node tests/test-requirements-tracking-1743.mjs
  • node tests/test-docs-options-sync.mjs
  • npm run lint
  • node tests/docs-validation.mjs
  • GITHUB_EVENT_NAME=pull_request GITHUB_BASE_SHA=$(git merge-base HEAD origin/main) GITHUB_HEAD_SHA=$(git rev-parse HEAD) node tests/test-docs-language-sync.mjs
  • GITHUB_BASE_REF=main GITHUB_BASE_SHA=$(git merge-base HEAD origin/main) GITHUB_HEAD_SHA=$(git rev-parse HEAD) node scripts/validate-changeset.mjs
  • npx prettier --check ... on touched files
  • npm test

References

  • Requirements ledger: docs/requirements/README.md
  • Case study: docs/case-studies/issue-1743/README.md

Fixes #1743

Adding .gitkeep for PR creation (default mode).
This file will be removed when the task is complete.

Issue: #1743
@konard konard self-assigned this May 2, 2026
@konard konard changed the title [WIP] --requirements-tracking Add requirements tracking option May 2, 2026
@konard
konard marked this pull request as ready for review May 2, 2026 07:19
@konard

konard commented May 2, 2026

Copy link
Copy Markdown
Contributor Author

Working session summary

Implemented and pushed the fix to PR 1744: #1744

What changed:

  • Added experimental --requirements-tracking.
  • Injected requirements-tracking guidance into all solver prompts.
  • Added PR verification that checks for docs/requirements/*.md changes and performs one restart when missing.
  • Added tests, docs, translated config docs, a changeset, and issue case-study requirement notes.

Verification:

  • node tests/test-requirements-tracking-1743.mjs
  • node tests/test-docs-options-sync.mjs
  • npm run lint
  • npm test passed: all 84 selected test files
  • node tests/docs-validation.mjs
  • node tests/test-docs-language-sync.mjs
  • Changeset validation passed

CI is green on the current head 8ebb6183fc5e00ef7f39066bdcb35dafc44ccbe7: https://github.com/link-assistant/hive-mind/actions/runs/25246804000

PR is open, marked ready, merge state is clean, and the local working tree is clean. Earlier CI failures were fixed by adding the changeset and updating the translated configuration docs.

References used during issue research: GitHub issue-linking docs https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue, ISO/IEC/IEEE 29148:2018 https://www.iso.org/cms/%20render/live/en/sites/isoorg/contents/data/standard/07/20/72089.html, NIST SP 500-204 https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication500-204.pdf.


This summary was automatically extracted from the AI working session output.

@konard

konard commented May 2, 2026

Copy link
Copy Markdown
Contributor Author

🤖 Solution Draft Log

This log file contains the complete execution trace of the AI solution draft process.

💰 Cost estimation:

  • Model: GPT-5.5
  • Provider: OpenAI
  • Public pricing estimate: $27.862431

📊 Context and tokens usage:

  • 21.0M / 1.1M (2000%) input tokens, 43.0K / 128K (34%) output tokens

Total: (548.0K + 20.4M cached) input tokens, 43.0K output tokens, $27.862431 cost

🤖 Models used:

  • Tool: OpenAI Codex
  • Requested: gpt-5.5
  • Model: GPT-5.5 (gpt-5.5)

📎 Log file uploaded as Repository (65200KB)


Now working session is ended, feel free to review and add any feedback on the solution draft.

@konard

konard commented May 2, 2026

Copy link
Copy Markdown
Contributor Author

✅ Ready to merge

This pull request is now ready to be merged:

  • All CI checks have passed
  • No merge conflicts
  • No pending changes

Monitored by hive-mind with --auto-restart-until-mergeable flag

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

--requirements-tracking

1 participant