Skip to content

Streamline AI coding assistant instructions#4922

Merged
nanangizz merged 1 commit intomasterfrom
docs/update-ai-instructions
Apr 15, 2026
Merged

Streamline AI coding assistant instructions#4922
nanangizz merged 1 commit intomasterfrom
docs/update-ai-instructions

Conversation

@nanangizz
Copy link
Copy Markdown
Member

@nanangizz nanangizz commented Apr 15, 2026

Summary

  • Reduce CLAUDE.md from 266 to 162 lines (39%)
  • Reduce copilot-instructions.md from 310 to 162 lines (48%)
  • Both files now have identical content

Removed (derivable from code, rarely referenced):

  • SIP module system code example, call flow diagram, media pipeline diagram
  • API layers table (PJSUA2/PJSUA-LIB/lower layers)
  • Test executable paths list (redundant with test commands)
  • Manual validation section, duplicate Do's/Don'ts

Added (practical lessons from development):

  • Skip make dep — produces corrupt .depend files; make auto-generates deps
  • Fix: find . -name "*.depend" -delete when "missing separator" errors occur
  • Tests must run from bin/ directory (cd pjlib/bin && ./pjlib-test-...)
  • make clean required when switching SSL backends (OpenSSL / GnuTLS)
  • config_site.h not tracked by git — safe for local config; CI uses config_site_test.h
  • --ci-mode widens timing tolerances for slow CI runners
  • Three build systems (GNU Make, MSVC, CMake) must all be updated when adding/removing source files
  • Documentation source repo (pjsip/pjproject_docs) for when docs site is not directly accessible

Co-Authored-By: Claude Code

@nanangizz nanangizz force-pushed the docs/update-ai-instructions branch from 1502d2a to f2a3c32 Compare April 15, 2026 06:20
Reduce CLAUDE.md (266→158 lines) and copilot-instructions.md
(310→158 lines), keeping both files in sync.

Removed (derivable from code, rarely needed):
- SIP module system code example
- SIP call flow / media pipeline diagrams
- API layers table
- Test executable paths list
- Manual validation section
- Redundant Do's/Don'ts

Added (lessons from development):
- Skip make dep (corrupt .depend files); make generates deps
- Delete .depend fix: find . -name "*.depend" -delete
- Tests must run from bin/ directory
- make clean required when switching SSL backends
- config_site.h not tracked by git, CI uses config_site_test.h
- --ci-mode widens timing tolerances for CI runners

Co-Authored-By: Claude Code
@nanangizz nanangizz force-pushed the docs/update-ai-instructions branch from f2a3c32 to 0692bbd Compare April 15, 2026 06:45
@nanangizz nanangizz merged commit 649bb3f into master Apr 15, 2026
53 of 54 checks passed
@nanangizz nanangizz deleted the docs/update-ai-instructions branch April 15, 2026 07:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants