Discipline your AI coding sessions

[avra]

If you use AI coding assistants like Claude Code, OpenCode and others, there is a way to make them actually behave, so every coding session becomes more disciplined, more predictable, and more productive:

https://github.com/zeljkoavramovic/karpathy-bernstein-avramovic

Happy Pascal coding !!! 

[440bx]

Sounds like something very useful.

I had to give up on Gemini before asking it to produce even a single line of code because it could not leave specs untouched which totally defeats the purpose of having a spec to determine what has to be done and also how.  It just couldn't help itself from making changes.

I'm pretty sure what you've shared there will come in handy once I tell Claude to produce code. 

Thank you Avra.

[avra]

Alternative presentation for people who do not like to read MD files:
https://zeljkoavramovic.github.io/karpathy-bernstein-avramovic/

Thank you Avra.

You're most welcome 

[devEric69]

Thank you @Avra: I'm using it ("Power is nothing without control.", as says an advertisement).

[avra]

Thank you @Avra: I'm using it ("Power is nothing without control.", as says an advertisement).

I am glad you like it 

If you want you can combine it with freepascal and lazarus specific skills from https://github.com/delphicleancode/lazarus-spec-kit. 

[Weiss]

interesting. If I understand it right, .md file must be in a project folder on my machine, and if I understand that part also, it means Claude needs its little app installed to be able to access .md file on my machine? I am reading about md file and AI misdemeanors, sounds scary. So far I used AI as a coach and guide, not the code writer. It shines as a tool to expand the documentation with concrete examples.

or do I just copy text with project particulars to AI at each session? It is same idea as md file, no?

By the way, I got into habit of keeping AI session open ( I am talking about Google AI Mode sessions) until I walked all the way through, which might take days, and doing it this way, every new AI instance replies as if that thing never left.

[avra]

If I understand it right, .md file must be in a project folder on my machine, and if I understand that part also, it means Claude needs its little app installed to be able to access .md file on my machine?

It all makes sense only if you use it with AI coding assistants like Claude Code, OpenCode, Codex, Google Antigravity, Claude Cowork, Codex Desktop, and others, since they all allow you to work on your local project folder. It is not useful for chat sessions used from your browser. MD file can be local to your project folder, but it is better to have it available for all your projects - which is what installation script does.

[440bx]

So far I used AI as a coach and guide, not the code writer. It shines as a tool to expand the documentation with concrete examples.

Just the standard word of caution about AI, as you have found, AI is a reasonably good coach but, you do have to keep in mind that the thing does make mistakes, sometimes even very simple mistakes.  What I'm saying here is that, don't ask it to write code for something you don't understand and cannot personally ensure is correct because if you do that, you don't have the knowledge necessary to catch the mistakes it does make and correct them.  The more sophisticated the code you ask it to write the more important following that rule becomes.

That said, if you're learning about something and, always keep in the back of your mind that the example it just provided you may contain errors, you should still be ok by learning from its errors in addition to yours

HTH.

[Weiss]

don't ask it to write code for something you don't understand and cannot personally ensure is correct because if you do that, you don't have the knowledge necessary to catch the mistakes it does make and correct them.  The more sophisticated the code you ask it to write the more important following that rule becomes.
HTH.

I hear you. The only time Claude wrote code for me, without being asked, it turned into a massive waste of time. It was thousands of line of code, where control have been lost. Nowadays I write every line of code myself. May sound a bit slow, but I find it more productive. AI only gives a brief on how certain tasks are achieved, with examples of use. Small tasks, piece by piece we work through many hours, and I have a complete control of my code. AI of course makes errors, but this is all very benign in nature, lecturing professors make errors too. As soon as general concept is clear, or certain class is mentioned, I am good.