I've only had one job with AFCI's ....
For the most part, they went in with no problems that a little troubleshooting couldn't quickly find and fix.
One of the bedroom lighting circuits was a different matter, though. No matter how we searched, we could not find the cause of the triping. In the end, we cheated, put in a regular breaker, and simply labled it 'lighting.'
We speculate that the complexity of the circuit ..... a multitude of dimmers, three-way switches, and fan/light combos .... may have been the cause of the problem.
That job was a good five years ago - I try not to get involved in new home construction - and things have worked well so far.