Engineering standards: isulti makausa, ipatuman kung asa importante
Ang kusina sa restawran adunay pipila ka lagda sa dingding ("maghugas og kamot") ug pipila nga nahimutang na sa kagamitan (mapalong ang oven kung maablihan ang pultahan). Ang poster sa dingding mahimong makalimtan. Ang built-in nga kandado dili. Ang maayong engineering standards naggamit sa duha, ug nahibalo kung asa kini nga lagda angay.
- Gibahin sa best-practices page sa Anthropic para sa Claude Code ang mga instruksyon sa duha ka klase. Ang giya (imong prompt,
CLAUDE.md, skills) gibasa sa model, nga "usually follows" niini apan dili pugson. Ang mga lagda nga gipatuman (hooks, permission rules, managed settings, tests, CI) gipatuman sa Claude Code o sa imong pipeline ug dili nagdepende sa pagpili sa model. - Tambag sa docs: kung padayon ka nga nagdugang og emphasis sa linya sa
CLAUDE.mdug nalimtan gihapon ni Claude, ang linya iya sa hook. Ang sukwahi tinuod usab: kung adunay ka mga hook para sa mga butang nga gusto ra, papasa kini ug pasagdi si Claude nga mopili. - Ang
CLAUDE.mdnaka-load sa matag session, mao nga ang matag linya mogasto og gamay nga atensyon sa matag buluhaton. Ipabilin kini alang sa dili makuha ni Claude gikan sa code: ang eksaktong test, typecheck ug lint nga mga command, desisyon nga wala sa repo, ug mga gotchas. Ang personal nga gusto ibutang saCLAUDE.local.md, nga imong idugang sa.gitignore. - Ang Claude Code nagabasa sa settings gikan sa daghang lugar. Ang scope nagdesisyon kung kinsa ang maapektuhan sa setting: user (
~/.claude/settings.json, ikaw sa matag proyekto), shared project (.claude/settings.json, tanan sa repo kung na-commit), project local (.claude/settings.local.json, ikaw sa usa ka proyekto) ug managed (gitakda sa organisasyon; walay sa imong kaugalingong mga file nga makabalhin niini). - Ang prayoridad, gikan sa pinakataas: managed settings, command-line
--settings, project local, shared project, user. Ang list settings sama sapermissions.allowgi-merge tali sa mga file imbes nga ilisan ang usag usa. - Ang pipila ka keys dili gyud molihok gikan sa file nga na-commit sa repo, ug ang pipila, sama sa
allowrules, maghulat hangtod mosalig ang matag teammate sa folder. Angdenyugaskrules molihok dayon. Padagana ang/statusaron makita kung unsang settings sources ang na-load. - Ang standards mapuslanon lang kung makit-an ug magamit sa mga tawo. Sulati ang usa ka mubo nga engineering standards file (among gitawag og
ENGINEERING.mdniini nga kurso) ug i-link kini gikan saCLAUDE.md.
| Lagda | Giya o gipatuman? | Asa nahimutang |
|---|---|---|
| "Gamita ang klaro nga mga ngalan sa function" | Giya | CLAUDE.md |
"Padagana ang python3 -m unittest sa dili pa nimo isulti nga human na" | Giya, dugang pa gipatuman sa Stop hook ug CI | CLAUDE.md, .claude/settings.json, CI |
"Ayaw gyud basaha ang .env" | Gipatuman | permissions.deny rule |
| "Walay ma-merge nga walay pasar nga test run ug usa ka human nga pag-aprobar" | Gipatuman | Branch protection (Lesson 2) |
"Ayaw hilabti ang migrations/ folder" | Gipatuman | PreToolUse hook nga mogawas nga adunay code 2 |
- Isulat ang matag lagda nga gisunod sa imong team o gusto nga masunod, usa kada linya, sa yano nga pulong.
- Alang sa matag lagda, pangutan-a: igo na ba ang "kasagaran"? Kung oo, kini giya. Kung dili, kini lagda nga nagkinahanglan og pagpatuman.
- Ibutang ang giya sa
CLAUDE.md, ipabilin nga mubo ang file. Iapil ang eksaktong mga command para sa test, typecheck ug lint. - Alang sa matag gipatuman nga lagda, pili og mekanismo gikan sa lamesa ug isulat kini: deny rule, hook, branch protection o CI.
- Himoa ang tinuod nga mga file:
.claude/settings.jsonnga adunay imong gipaambit nga mga lagda, na-commit sa repo, ug.claude/settings.local.jsonalang sa personal nga overrides, gipapahilayo sa Git. - Sulati ang
ENGINEERING.mdsa usa ka pahina nga adunay tulo ka seksyon: unsaon namo pagtrabaho, unsaon namo pag-review, unsaon namo pag-ship. - Padagana ang
/statusug susiha nga ang settings sources sama sa imong gipaabot. - Check: ang bag-ong teammate makakita sa test command sulod sa usa ka minuto, ug makaturo ka sa eksaktong lugar diin gipatuman ang matag "never" nga lagda.
Videos by other creators on YouTube, for reference. They are not made by or affiliated with The Future Market.
Read the video script
[Host] "Ang poster sa dingding mahimong dili sundon. Ang kandado sa pultahan dili."
[Text on screen: Giya batok gipatuman] "Ang pipila ka lagda kay giya, sama sa nota sa CLAUDE.md. Ang pipila gipatuman, sama sa deny rule o gikinahanglan nga check."
[Screen: ang lamesa sa mga lagda] "Pangutan-a og usa ka pangutana sa matag lagda: igo na ba ang kasagaran?"
[Text on screen: Ipabilin nga mubo ang CLAUDE.md] "Kung dili, ibalhin kini gikan sa mga nota ngadto sa hook, permission rule o imong pipeline."
[Host] "Mubo nga mga nota, kusgan nga kandado, ug usa ka pahina nga makit-an sa tanan."
Isulat ang listahan sa lagda sa imong team (labing menos napulo ka lagda), ibutang sa giya ug gipatuman, ug himoa ang mga file nga nagkupot sa matag usa. Unya sulati ang ENGINEERING.md sa usa ka pahina.
ClaudeStuck? Copy a ready-made prompt for Claude
Copy this, open Claude, paste it, and Claude will walk you through the lesson step by step.
For a grown-up: Claude is for adults (18+). Copy this, paste it into Claude, and use the answer to explain the lesson to your child.
I'm learning "AI Engineering Practice: i-ship ug i-maintain ang software nga gihimo sa AI" on The Future Market. Lesson 1: "Engineering standards: isulti makausa, ipatuman kung asa importante". What the lesson teaches: - Gibahin sa best-practices page sa Anthropic para sa Claude Code ang mga instruksyon sa duha ka klase. Ang giya (imong prompt, CLAUDE.md, skills) gibasa sa model, nga "usually follows" niini apan dili pugson. Ang mga lagda nga gipatuman (hooks, permission rules, managed settings, tests, CI) gipatuman sa Claude Code o sa imong pipeline ug dili nagdepende sa pagpili sa model. - Tambag sa docs: kung padayon ka nga nagdugang og emphasis sa linya sa CLAUDE.md ug nalimtan gihapon ni Claude, ang linya iya sa hook. Ang sukwahi tinuod usab: kung adunay ka mga hook para sa mga butang nga gusto ra, papasa kini ug pasagdi si Claude nga mopili. - Ang CLAUDE.md naka-load sa matag session, mao nga ang matag linya mogasto og gamay nga atensyon sa matag buluhaton. Ipabilin kini alang sa dili makuha ni Claude gikan sa code: ang eksaktong test, typecheck ug lint nga mga command, desisyon nga wala sa repo, ug mga gotchas. Ang personal nga gusto ibutang sa CLAUDE.local.md, nga imong idugang sa .gitignore. - Ang Claude Code nagabasa sa settings gikan sa daghang lugar. Ang scope nagdesisyon kung kinsa ang maapektuhan sa setting: user (~/.claude/settings.json, ikaw sa matag proyekto), shared project (.claude/settings.json, tanan sa repo kung na-commit), project local (.claude/settings.local.json, ikaw sa usa ka proyekto) ug managed (gitakda sa organisasyon; walay sa imong kaugalingong mga file nga makabalhin niini). - Ang prayoridad, gikan sa pinakataas: managed settings, command-line --settings, project local, shared project, user. Ang list settings sama sa permissions.allow gi-merge tali sa mga file imbes nga ilisan ang usag usa. - Ang pipila ka keys dili gyud molihok gikan sa file nga na-commit sa repo, ug ang pipila, sama sa allow rules, maghulat hangtod mosalig ang matag teammate sa folder. Ang deny ug ask rules molihok dayon. Padagana ang /status aron makita kung unsang settings sources ang na-load. - Ang standards mapuslanon lang kung makit-an ug magamit sa mga tawo. Sulati ang usa ka mubo nga engineering standards file (among gitawag og ENGINEERING.md niini nga kurso) ug i-link kini gikan sa CLAUDE.md. The exercise I'm working on: Isulat ang listahan sa lagda sa imong team (labing menos napulo ka lagda), ibutang sa giya ug gipatuman, ug himoa ang mga file nga nagkupot sa matag usa. Unya sulati ang ENGINEERING.md sa usa ka pahina. I'm stuck. Please: 1. Explain the main idea in plain, simple words with one everyday example. 2. Walk me through the exercise one small step at a time. Ask me what I've done so far before giving the next step. 3. Don't just give me the final answer. Help me do it myself, and check my work when I share it.
I'm a parent helping my child (about 8 years old) with a lesson called "Engineering standards: isulti makausa, ipatuman kung asa importante" from the course "AI Engineering Practice: i-ship ug i-maintain ang software nga gihimo sa AI".
Here's what the lesson says:
Ang kusina sa restawran adunay pipila ka lagda sa dingding ("maghugas og kamot") ug pipila nga nahimutang na sa kagamitan (mapalong ang oven kung maablihan ang pultahan). Ang poster sa dingding mahimong makalimtan. Ang built-in nga kandado dili. Ang maayong engineering standards naggamit sa duha, ug nahibalo kung asa kini nga lagda angay.
The activity:
Isulat ang listahan sa lagda sa imong team (labing menos napulo ka lagda), ibutang sa giya ug gipatuman, ug himoa ang mga file nga nagkupot sa matag usa. Unya sulati ang ENGINEERING.md sa usa ka pahina.
Please explain this so an 8-year-old understands: short sentences, a fun everyday example, and no hard words.
Then give me 3 simple questions I can ask my child to check they understood, and a way to do the activity together, one tiny step at a time.Sources
- Anthropic, Best practices for Claude Code: code.claude.com/docs/en/best-practices
- Anthropic, Settings files and precedence: code.claude.com/docs/en/settings
- Anthropic, Configure permissions: code.claude.com/docs/en/permissions
Review pipeline alang sa code nga wala nimo gisulat
This lesson is part of full access: every course and every level for one payment.
Mga test isip gates, ug pagsusi sa mga test mismo
This lesson is part of full access: every course and every level for one payment.
Security checks alang sa code nga gitabangan sa AI
This lesson is part of full access: every course and every level for one payment.
Claude Code sa mga script ug CI, nga adunay limitasyon
This lesson is part of full access: every course and every level for one payment.
Mag-ship sa gagmayng lakang ug ipabilin nga maintainable
This lesson is part of full access: every course and every level for one payment.
Manguna sa gamay nga team ug idokumento ang workflow
This lesson is part of full access: every course and every level for one payment.
Final project
This lesson is part of full access: every course and every level for one payment.
Quiz
Unsay kalainan sa giya ug gipatuman nga lagda?
Ang giya (prompt o CLAUDE.md) gibasa sa model, nga kasagarang mosunod niini. Ang gipatuman nga lagda (hook, deny rule, branch protection o CI) gipatuman sa tool o pipeline bisan unsa pa ang desisyon sa model.
Asa angay ibutang ang "ayaw basaha ang .env" nga lagda?
Sa permissions deny rule (ug sa sandbox alang sa mas kusog nga limitasyon), dili lang sa CLAUDE.md.
Ang AI code review ba mo-aprobar o mo-block sa pull request?
Dili. Mobiya kini og mga nakita, ug ang desisyon nga mo-merge nagpabilin sa mga tawo.
Ngano nga ang Code Review mobasa sa REVIEW.md gikan sa base branch ug dili gikan sa pull request?
Aron ang pull request dili makabag-o sa mga lagda nga gigamit sa pag-review sa kaugalingon niini.
Unsay buhat sa CODEOWNERS file?
Nagngalan kini sa mga tawo o team nga responsable sa mga bahin sa code, nga gipangayoan nga mo-review sa mga pagbag-o niadtong mga file.
Unsa ang mutation check?
Usba ang code og tuyo sa gamay ug susiha nga mapakyas ang usa ka test. Kung pasar gihapon ang mga test, huyang kaayo sila.
Unsaon nimo paghimo nga ang napakyas nga test mopugong sa merge?
Padagana ang mga test sa CI ug i-on ang gikinahanglan nga status checks sa branch protection.
Unsang mga timaan sa pasidaan ang angay tan-awon sa human reviewer sa diff nga gisulat sa AI?
Mga file nga dili gipaabot, gitangtang o gihuyang nga mga test, mga test nga giusab aron mohaum sa bug, bag-ong dependencies, hard-coded nga mga sekreto ug code nga walay makapasabot.
Unsay buhat sa push protection?
Mag-block kini sa mga push nga adunay gisuportahan nga mga sekreto sa dili pa makaabot sa repository.
Ngalana ang tulo ka limitasyon nga imong i-set sa unattended nga Claude Code run.
Pananglitan mubo nga allowed-tools list, dontAsk permission mode, turn o budget cap, ug workflow timeout.
Ngano nga gamiton ang --bare sa mga script ug CI?
Molaktaw kini sa auto-discovered nga hooks, plugins, MCP servers ug CLAUDE.md, aron ang run mohimo sa parehas nga butang sa matag makina.
Unsaon nimo pag-undo ang na-ship nga commit ug ipabilin ang kasaysayan?
Gamita ang git revert, nga naghimo og bag-ong commit nga mobalik sa naunang usa.
Final exam
This lesson is part of full access: every course and every level for one payment.
Certificate
This lesson is part of full access: every course and every level for one payment.