Add .issueflows/04-designs-and-guides/ folder (#26)

[jepegit]

Summary

Gives issue-flow projects a durable home for long-lived design docs, design decisions, and agreed good-practices:

• New folder .issueflows/04-designs-and-guides/ — created by issue-flow init, recreated by issue-flow update only when missing, and never overwritten by update (the folder is a directory, not a TEMPLATE_MANIFEST entry).
• Config plumbing. Settings.designs_folder = "04-designs-and-guides" threaded through issueflows_subdirs and the Jinja template_context as {{ designs_folder }}. Same pattern as the other numbered subdirs — no new env var.
• Rule file (issueflow-rules.mdc) now lists the folder in the issue-tracking tree and adds a "Designs and guides" section describing what belongs there and when to read / write it.
• Slash commands reference the folder:
  • /issue-plan — new step 1.5 "Consult existing designs / guides" plus a Files-to-touch reminder when the plan expects to produce a design doc.
  • /issue-start — sub-bullet in step 2 to read relevant designs and record new non-trivial design decisions.
  • /issue-close — sanity-check bullet to confirm design decisions are captured before committing.
  • /iflow and /issue-yolo — short header notes; /issue-yolo flags that uncovered design decisions usually mean the change is too big for yolo.
• Tests. Extended test_init.py and test_config.py, and added test_update.py cases that (a) preserve user content inside the folder across run_update and (b) recreate the folder if it was deleted.

Also:

• Bumped to 0.2.3 via uv version --bump patch.
• Promoted ## [Unreleased] in HISTORY.md to ## [0.2.3] - 2026-04-19 with a bullet for create a new folder for storing designs and design decissions #26.
• Archived issue26_original.md / issue26_status.md into .issueflows/03-solved-issues/.

Left intentionally out of scope (noted in the status file): docs/cursor-issue-workflow.md.j2 and the skills/ templates will pick up the same wording in a follow-up.

Test plan

• uv run pytest — 68 passed.
• Manual scratch-dir walkthrough: init creates .issueflows/04-designs-and-guides/.gitkeep; user file inside the folder survives update; deleting the folder then running update recreates it with .gitkeep.

Closes #26.

Made with Cursor