save HS knowledge

[Besroy]

This PR aims to preserve knowledge generated during regular debugging and work, making it easier for AI to understand our architecture without having to read the code every time it needs to solve a problem. Let's save them here for supplementation and correction. No need to merge it now, as it is still in a very early and rough stage

[xiaoxichen]

dont use the "generated by claude" , regardless what tool generated this or an alien sent it to you secretly, it is the human 's responsibility of correctness :)

[codecov-commenter]

⚠️ Please install the to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 48.46%. Comparing base (1a0cef8) to head (1ce002f).
⚠️ Report is 307 commits behind head on master.
❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #851      +/-   ##
==========================================
- Coverage   56.51%   48.46%   -8.05%     
==========================================
  Files         108      110       +2     
  Lines       10300    12757    +2457     
  Branches     1402     6134    +4732     
==========================================
+ Hits         5821     6183     +362     
+ Misses       3894     2493    -1401     
- Partials      585     4081    +3496     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[JacksonYao287]

this is also good for the later new comers to understand how homestore works ASAP.

can you also put what prompts are you using to generate this detailed doc? I think this is also important.

IMO, in the future we (human being) need to improve the capability of generating precious prompts and the way how we ask AI will matter more and more.